必须挂载宿主机插件目录至容器 /root/.fitten/plugins 并执行 fitten-cli plugin scan --force 才能正常加载插件,否则因路径错误或未触发扫描导致插件无法激活。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在 Docker 容器中让 Fitten Code 正常加载并使用插件(如代码补全、Git 集成、本地 LLM 调用等),必须绕过其默认的插件沙箱机制——容器内无 GUI、无用户主目录、无系统级插件注册路径,直接复用宿主机插件会失败或报错“plugin not found”。
确认 Fitten Code 容器镜像是否含插件运行时依赖
第一步:拉取官方镜像后,启动交互式容器检查 Node.js 与 npm 环境。
docker run -it --rm fitencode/fitten-code:latest /bin/sh → node -v && npm -v
若返回 【Node.js 版本低于 18.17.0 或 npm 不可用】,说明该镜像未预装插件所需运行时,必须基于此镜像构建自定义版本,否则所有插件均无法激活。
挂载宿主机插件目录到容器指定路径
Fitten Code 在容器中默认查找插件的路径是 /root/.fitten/plugins,而非宿主机的 ~/.fitten/plugins。直接映射用户目录会导致权限拒绝或路径不可见。
方法一:显式挂载并修正所有权
mkdir -p ~/.fitten/plugins && chown -R 0:0 ~/.fitten/plugins
docker run -d \
-v ~/.fitten/plugins:/root/.fitten/plugins:ro \
-v /path/to/your/project:/workspace \
-p 3000:3000 \
fitencode/fitten-code:latest
注意:ro(只读)挂载是必须的,【写入宿主机插件目录可能破坏插件签名验证,导致启动失败】。
在容器内启用插件的三步初始化
① 进入正在运行的容器:docker exec -it <container_id> /bin/sh</container_id>
② 手动触发插件扫描(关键):fitten-cli plugin scan --force
这一步不能省略——容器启动时不会自动执行插件发现逻辑,必须显式调用 CLI 工具强制重载。
③ 验证已加载插件:fitten-cli plugin list,输出应包含插件名、状态(active)、版本号;若显示 0 plugins found,说明挂载路径错误或插件包结构不合规(例如缺少 package.json 或 main.js 入口)。
Docker Hub (hub.docker.com)。此技能适用于所有 Docker Hub 操作,包括读取、创建、更新和删除数据。只要任务涉及 Docker Hub,就使用此技能。
为 Git 插件配置 SSH 密钥穿透
Git 插件需访问私有仓库,但容器默认无 SSH agent 转发能力。
方法一:绑定挂载 SSH socket(推荐)
docker run -d \
-v ~/.ssh:/root/.ssh:ro \
-v /run/user/$(id -u)/ssh-agent.sock:/run/ssh-agent.sock \
-e SSH_AUTH_SOCK=/run/ssh-agent.sock \
fitencode/fitten-code:latest
方法二:注入密钥文件(仅限测试环境)
echo "$SSH_PRIVATE_KEY" | docker run -i \
-v /dev/stdin:/root/.ssh/id_rsa:ro \
fitencode/fitten-code:latest sh -c "chmod 600 /root/.ssh/id_rsa && fitten-cli plugin enable git"
这一步操作起来很简单,直接把密钥内容通过管道传进去就行,但【生产环境严禁使用方法二,密钥会残留于容器层历史中】。
本地 LLM 插件连接容器内推理服务
当使用 Ollama 或 vLLM 启动模型服务时,Fitten Code 插件默认尝试连接 http://localhost:11434 —— 这在容器内指向自身,而非宿主机。
解决方案:改用宿主机网关地址
Linux/macOS:将插件配置中的 API 地址设为 http://host.docker.internal:11434
Windows(WSL2):必须用 http://192.168.49.1:11434(Minikube 默认网关)或实际宿主机 IP
验证连通性:curl -s http://host.docker.internal:11434/api/tags | jq '.models[].name',若返回模型列表,说明网络可达。

















