5 步用 Docker 跑起多用户 AI 助手 Octop【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/OctopOctop 是一个多用户、多智能体的自托管 AI 助手用 Docker 部署它只需要一条 Compose 命令。按本文走一遍10 分钟内你就能在一台裸服务器上拿到一个可登录、可对话的私有助手全程不用手写任何配置。下面先给最短可运行命令再讲镜像为什么这么搭、哪些坑能提前绕开。让容器替你装依赖、配端口、建账号自托管一个 AI 服务真正耗时的从来不是写业务代码而是手动装依赖、配端口、初始化数据库、建管理员账号这一串零碎活。换个机器全得重来一遍还容易漏掉某一步导致起不来。Octop 把这串活全塞进了 Docker 镜像和入口脚本里构建阶段编译前端、装好 Python 依赖启动阶段自动完成数据库初始化和账号引导。用户隔离、多智能体运行时这些都在容器内自行管理你只管执行命令。一条命令跑起你的私有 Octop克隆仓库到服务器git clone https://gitcode.com/GitHub_Trending/oct/Octop一条命令构建并启动数据库和配置自动落到宿主机~/.octopdocker compose -f docker/docker-compose.yml up -d --build浏览器打开http://服务器IP:8088首次进入走设置向导填好管理员账号和密码。登录进去就能直接对话、建智能体、配模型了。想手动控制构建过程也可用封装脚本bash docker/docker_build.sh它默认开 BuildKit 缓存只改代码时重建通常一两分钟。看懂这三个构建加速设计镜像是两段式docker/Dockerfile 先用node:20-slim把前端 dashboard/ 打成静态文件再切python:3.12-slim跑后端最终只留最精简的运行时。三个细节决定了它快不卡。用锁文件和缓存挂载换构建速度只改代码时依赖层缓存直接命中二次构建往往一两分钟就完。做法是先装依赖、后拷源码再给 npm、uv、apt 的下载挂上缓存卷跨构建复用前提是开 BuildKit而 docker/docker_build.sh 已经替你设好DOCKER_BUILDKIT1。装完编译依赖立刻拆工具链最终镜像更小浏览器自动化渲染中文也不受影响。做法是编译型依赖装完就 purgebuild-essential、清空 apt 缓存只留libffi、curl和中文字体编译型依赖多首次构建会慢一次但只慢这一次。把首次初始化交给入口脚本你不用在宿主机手动建库或跑迁移docker stop也能优雅退出。docker/docker-entrypoint.sh 检测不到/data/.octop/octop.db就判定为全新数据卷自动初始化最后exec octop run以 1 号进程接管信号容器也不会因弱密码反复重启。先绕开这三个高频坑⚠️ 首次启动默认不自动建管理员。只有你传了合格的OCTOP_DEFAULT_PASSWORD≥8 位、含字母和数字、不在弱密码黑名单才会直接建好 admin否则入口脚本把向导口令写进/data/.octop/octop-login.txt让你打开网页走设置向导。想要全自动就显式传一个强密码。⚠️ Compose 的构建上下文是仓库根目录context: ..别在docker/目录里跑裸docker compose up否则前端和后端源码都找不到。⚠️ 数据卷挂载到/data/.octop而容器里HOME固定为/data两者必须对齐对不齐的话配置和数据库会写进容器内部重启即丢。数据库默认内置 SQLite开箱即用数据量大、要并发或接向量检索才切 PostgreSQL用 docker/docker-compose.postgres.yml 起一个pgvector/pgvector:pg16托管环境直接接云厂商 RDS再在 Octop 侧配上OCTOP_DATABASE_URL即可。部署完接着做这几件事看版本和实时日志docker exec -it octop octop --version、docker logs -f octop首次登录后立刻改掉默认管理员密码在控制台配好至少一家 LLM 提供商的 Key如OPENAI_API_KEY、DASHSCOPE_API_KEY要暴露公网就先加反向代理 TLS别裸奔 8088确认数据卷~/.octop落在宿主机删容器不丢数据以后拉新代码直接docker compose -f docker/docker-compose.yml up -d --build重建即完成升级整套 Docker 部署链路到这里就跑通了。【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/Octop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考