Atomic自托管部署终极指南Docker Compose、Fly.io上线与数据备份安全【免费下载链接】atomicSelf-hosted, semantically-connected personal knowledge base项目地址: https://gitcode.com/gh_mirrors/atomic25/atomicAtomic 是一款自托管、语义互联的个人知识库支持 AI 对话、语义搜索与 Wiki 自动合成。本指南带你用最简单的三步完成Atomic 自托管部署Docker Compose 一键本地部署、Fly.io 云端上线以及数据备份安全保障无需复杂运维经验也能 10 分钟跑起来。一、Docker Compose 一键部署步骤Atomic 官方推荐使用 Docker Compose 作为自托管的起点。仓库内已内置完整的 docker-compose.yml只需四条命令git clone https://gitcode.com/gh_mirrors/atomic25/atomic.git cd atomic echo ATOMIC_SETUP_TOKEN$(openssl rand -base64 24) .env docker compose up -d启动后访问http://localhost:8080即可看到 Atomic 的 Web 界面默认启动的 4 个服务服务镜像作用serverghcr.io/kenforthewin/atomic-serverREST API、WebSocket 事件、MCP 端点、定时任务webghcr.io/kenforthewin/atomic-web浏览器前端界面proxynginx:1.28-bookworm反向代理宿主端口8080litestreamlitestream/litestream:0.3可选备份服务backupprofile 所有数据都持久化在atomic-data卷中只要卷还在重建容器数据也不会丢失。快速配置 AI 提供商首次打开界面时会进入引导向导。你可以选择 OpenRouter、Ollama 或其他 OpenAI 兼容服务。配置完成后的效果——多模态语义搜索、画布图谱和 AI 对话——如下所示二、首次运行设置Setup Token 与 API Token这是很多新手容易卡住的一步请仔细看打开http://localhost:8080进入设置向导输入.env中生成的ATOMIC_SETUP_TOKEN向导会创建第一个API Token并只显示一次——务必保存好在设置中配置 AI 提供商如 OpenRouter / Ollama⚠️安全提示ATOMIC_SETUP_TOKEN是实例的认领密钥。新实例未配置该令牌时任何能访问服务器的人都可以认领它公网部署时必须配置。相关细节可查阅 首次运行设置文档 与 令牌管理文档。配置完成后你的个人知识库就真正活起来了三、公网部署配置 PUBLIC_URL 与反向代理要把 Atomic 暴露到公网比如绑一个自己的域名关键只有一个环境变量PUBLIC_URLhttps://atomic.yourdomain.com docker compose up -dPUBLIC_URL用于 OAuth / MCP 服务发现——不设置它MCP 远程认证端点会返回 404。如果你不用内置的 nginx而是自己已有 Caddy、Traefik 等代理请确保转发以下路由参考 docker/nginx.conf 的完整写法/api/*— 标准 HTTP API需关闭缓冲以支持流式响应/ws— WebSocket 升级聊天、摄取进度实时更新/mcp— MCP 端点SSE 流式/.well-known/*— OAuth 服务发现# docker/nginx.conf 核心逻辑节选 location /api/ { proxy_pass http://atomic_server; proxy_buffering off; # 聊天流式响应 proxy_read_timeout 300s; # AI 长任务超时 } location /ws { proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; }完整配置项端口、存储后端、缓存调优等见 配置参考。四、Fly.io 云端快速上线想跳过自己维护服务器仓库提供了现成的 fly.toml.example用all-in-one单容器镜像server nginx 前端打包在一起见 Dockerfile 第 5 阶段cp fly.toml.example fly.toml fly launch --copy-config --no-deploy fly volumes create atomic_data fly secrets set ATOMIC_SETUP_TOKEN你的令牌 fly deploy关键配置解读target all-in-one— 使用单容器构建内嵌 supervisor 管理 server 与 nginx[[mounts]]— 持久卷atomic_data挂载到/dataSQLite 数据库安全落盘auto_stop_machines suspendauto_start_machines true— 闲置自动休眠有请求自动唤醒适合低频使用size shared-cpu-1x/memory 512mb— 最低 512MB 内存即可运行成本极低健康检查每 30 秒GET /health与 Fly 调度无缝配合五、数据备份安全Litestream 与 Markdown 导出知识库是核心资产备份必须做对。1. 理解数据布局Atomic 的数据目录结构默认在atomic-data卷中databases/ registry.db # 全局元数据API 令牌、设置、数据库记录 default.db # 数据原子、标签、向量嵌入、Wiki、聊天记录 database-id.db # 多数据库部署下的其他库备份黄金法则备份整个数据目录或 Docker 卷绝不能只备份default.db——漏掉registry.db意味着 API 令牌和数据库元数据全部丢失。2. 开启 Litestream 实时备份S3compose 文件内置了litestream服务将 SQLite 增量同步到 S3 兼容存储sync-interval: 10s意味着最多丢失 10 秒的数据。配置以下环境变量后启用docker compose --profile backup up -dLITESTREAM_ACCESS_KEY_ID/LITESTREAM_SECRET_ACCESS_KEYLITESTREAM_BUCKET/LITESTREAM_ENDPOINT/LITESTREAM_PATH备份配置见 docker/litestream.yml每 1 小时生成一次快照支持精确到秒级 LSN 的恢复。上线前务必先演练一次恢复。3. Markdown 导出兜底除卷级备份外还可以随时把整个库导出为 Markdown原子 标签完整保留这是最保险的人可读备份curl -X POST http://localhost:8080/api/databases/db-id/exports/markdown \ -H Authorization: Bearer token导出完成后从任务响应中取download_path立即下载令牌有效期很短。完整备份指南见 数据与备份文档。六、版本升级与故障排查升级只需两条命令docker compose pull docker compose up -d curl http://localhost:8080/health # 验证升级成功常见问题速查表症状排查方向Web 界面能打开但 API 报错检查代理的/api/*路由转发聊天 / 摄取进度不更新检查/ws的 WebSocket 升级头MCP 远程认证失败确认设置了PUBLIC_URL且/.well-known/oauth-authorization-server可访问重建容器后数据消失确认复用了原atomic-data卷docker volume inspect atomic_atomic-data内存占用偏高调整ATOMIC_SERVER_READ_POOL_SIZE与ATOMIC_SQLITE_CACHE_KB低内存主机建议调低读池写在最后到这里你的 Atomic 自托管部署已经完整闭环Docker Compose 快速起步 → 公网域名上线 → Fly.io 低成本云端部署 → Litestream Markdown 双重备份。个人知识库最怕数据蒸发只要卷备份和 Markdown 导出双管齐下就基本无后顾之忧。 延伸阅读部署细节Docker Compose 文档自托管总览getting-started/self-hosting.md备份策略data-and-backups.md语义嵌入管线原理embedding-tagging-pipeline.md【免费下载链接】atomicSelf-hosted, semantically-connected personal knowledge base项目地址: https://gitcode.com/gh_mirrors/atomic25/atomic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/8 20:08:48 · 阅读 1.2k Atomic自托管部署终极指南：Docker Compose、Fly.io上线与数据备份安全
Atomic自托管部署终极指南Docker Compose、Fly.io上线与数据备份安全【免费下载链接】atomicSelf-hosted, semantically-connected personal knowledge base项目地址: https://gitcode.com/gh_mirrors/atomic25/atomicAtomic 是一款自托管、语义互联的个人知识库支持 AI 对话、语义搜索与 Wiki 自动合成。本指南带你用最简单的三步完成Atomic 自托管部署Docker Compose 一键本地部署、Fly.io 云端上线以及数据备份安全保障无需复杂运维经验也能 10 分钟跑起来。一、Docker Compose 一键部署步骤Atomic 官方推荐使用 Docker Compose 作为自托管的起点。仓库内已内置完整的 docker-compose.yml只需四条命令git clone https://gitcode.com/gh_mirrors/atomic25/atomic.git cd atomic echo ATOMIC_SETUP_TOKEN$(openssl rand -base64 24) .env docker compose up -d启动后访问http://localhost:8080即可看到 Atomic 的 Web 界面默认启动的 4 个服务服务镜像作用serverghcr.io/kenforthewin/atomic-serverREST API、WebSocket 事件、MCP 端点、定时任务webghcr.io/kenforthewin/atomic-web浏览器前端界面proxynginx:1.28-bookworm反向代理宿主端口8080litestreamlitestream/litestream:0.3可选备份服务backupprofile 所有数据都持久化在atomic-data卷中只要卷还在重建容器数据也不会丢失。快速配置 AI 提供商首次打开界面时会进入引导向导。你可以选择 OpenRouter、Ollama 或其他 OpenAI 兼容服务。配置完成后的效果——多模态语义搜索、画布图谱和 AI 对话——如下所示二、首次运行设置Setup Token 与 API Token这是很多新手容易卡住的一步请仔细看打开http://localhost:8080进入设置向导输入.env中生成的ATOMIC_SETUP_TOKEN向导会创建第一个API Token并只显示一次——务必保存好在设置中配置 AI 提供商如 OpenRouter / Ollama⚠️安全提示ATOMIC_SETUP_TOKEN是实例的认领密钥。新实例未配置该令牌时任何能访问服务器的人都可以认领它公网部署时必须配置。相关细节可查阅 首次运行设置文档 与 令牌管理文档。配置完成后你的个人知识库就真正活起来了三、公网部署配置 PUBLIC_URL 与反向代理要把 Atomic 暴露到公网比如绑一个自己的域名关键只有一个环境变量PUBLIC_URLhttps://atomic.yourdomain.com docker compose up -dPUBLIC_URL用于 OAuth / MCP 服务发现——不设置它MCP 远程认证端点会返回 404。如果你不用内置的 nginx而是自己已有 Caddy、Traefik 等代理请确保转发以下路由参考 docker/nginx.conf 的完整写法/api/*— 标准 HTTP API需关闭缓冲以支持流式响应/ws— WebSocket 升级聊天、摄取进度实时更新/mcp— MCP 端点SSE 流式/.well-known/*— OAuth 服务发现# docker/nginx.conf 核心逻辑节选 location /api/ { proxy_pass http://atomic_server; proxy_buffering off; # 聊天流式响应 proxy_read_timeout 300s; # AI 长任务超时 } location /ws { proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; }完整配置项端口、存储后端、缓存调优等见 配置参考。四、Fly.io 云端快速上线想跳过自己维护服务器仓库提供了现成的 fly.toml.example用all-in-one单容器镜像server nginx 前端打包在一起见 Dockerfile 第 5 阶段cp fly.toml.example fly.toml fly launch --copy-config --no-deploy fly volumes create atomic_data fly secrets set ATOMIC_SETUP_TOKEN你的令牌 fly deploy关键配置解读target all-in-one— 使用单容器构建内嵌 supervisor 管理 server 与 nginx[[mounts]]— 持久卷atomic_data挂载到/dataSQLite 数据库安全落盘auto_stop_machines suspendauto_start_machines true— 闲置自动休眠有请求自动唤醒适合低频使用size shared-cpu-1x/memory 512mb— 最低 512MB 内存即可运行成本极低健康检查每 30 秒GET /health与 Fly 调度无缝配合五、数据备份安全Litestream 与 Markdown 导出知识库是核心资产备份必须做对。1. 理解数据布局Atomic 的数据目录结构默认在atomic-data卷中databases/ registry.db # 全局元数据API 令牌、设置、数据库记录 default.db # 数据原子、标签、向量嵌入、Wiki、聊天记录 database-id.db # 多数据库部署下的其他库备份黄金法则备份整个数据目录或 Docker 卷绝不能只备份default.db——漏掉registry.db意味着 API 令牌和数据库元数据全部丢失。2. 开启 Litestream 实时备份S3compose 文件内置了litestream服务将 SQLite 增量同步到 S3 兼容存储sync-interval: 10s意味着最多丢失 10 秒的数据。配置以下环境变量后启用docker compose --profile backup up -dLITESTREAM_ACCESS_KEY_ID/LITESTREAM_SECRET_ACCESS_KEYLITESTREAM_BUCKET/LITESTREAM_ENDPOINT/LITESTREAM_PATH备份配置见 docker/litestream.yml每 1 小时生成一次快照支持精确到秒级 LSN 的恢复。上线前务必先演练一次恢复。3. Markdown 导出兜底除卷级备份外还可以随时把整个库导出为 Markdown原子 标签完整保留这是最保险的人可读备份curl -X POST http://localhost:8080/api/databases/db-id/exports/markdown \ -H Authorization: Bearer token导出完成后从任务响应中取download_path立即下载令牌有效期很短。完整备份指南见 数据与备份文档。六、版本升级与故障排查升级只需两条命令docker compose pull docker compose up -d curl http://localhost:8080/health # 验证升级成功常见问题速查表症状排查方向Web 界面能打开但 API 报错检查代理的/api/*路由转发聊天 / 摄取进度不更新检查/ws的 WebSocket 升级头MCP 远程认证失败确认设置了PUBLIC_URL且/.well-known/oauth-authorization-server可访问重建容器后数据消失确认复用了原atomic-data卷docker volume inspect atomic_atomic-data内存占用偏高调整ATOMIC_SERVER_READ_POOL_SIZE与ATOMIC_SQLITE_CACHE_KB低内存主机建议调低读池写在最后到这里你的 Atomic 自托管部署已经完整闭环Docker Compose 快速起步 → 公网域名上线 → Fly.io 低成本云端部署 → Litestream Markdown 双重备份。个人知识库最怕数据蒸发只要卷备份和 Markdown 导出双管齐下就基本无后顾之忧。 延伸阅读部署细节Docker Compose 文档自托管总览getting-started/self-hosting.md备份策略data-and-backups.md语义嵌入管线原理embedding-tagging-pipeline.md【免费下载链接】atomicSelf-hosted, semantically-connected personal knowledge base项目地址: https://gitcode.com/gh_mirrors/atomic25/atomic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考