9.4 万星:聊天、邮件、文档、日历,全装进一个自托管后台

我数过自己上班时开着的东西：一个 AI 对话的网页标签、一个笔记软件、一个邮箱客户端、一个日历、一个文档工具、外加一个专门管本地模型的界面。六样东西，六套账号，六个密码，每换台机器就重登一遍。

这两天翻到一个项目叫 Odysseus，描述只有一句话：自托管的 AI 工作台。GitHub 上 94,402 颗星。它干的事就是把这六样东西塞进一个开在自己机器上的网页，聊天记录、邮件、笔记、模型全存在本地的 data/ 目录里。

我把 README 和那份七百多行的安装文档从头读到尾，这篇讲它到底装了什么、装的时候会撞见哪几个坑、哪几处最好别指望。

 

它是什么，谁在做

仓库挂在 odysseus-dev 这个组织下面，主语言 Python，协议是 AGPL-3.0-or-later，不是 MIT 那种随便用的。建库是 2026 年 5 月 31 日，到今天五个多月，冲到 94,402 星、1,753 次 fork，贡献者上百位——这个速度不像个人项目，背后是一个成型的小团队。

它的自我定位写在 README 第二行：给聊天、代理、研究、文档、邮件、笔记、日历和本地模型工作流用的自托管工作台。不开 SaaS，不收订阅，装在你自己的机器上，默认只绑 127.0.0.1，外面的人碰不到。

有件事得先讲明白，别被星数带跑：它有 1,517 个没关的 issue。这数字放在一个五个月的项目上，说明它跑得很快，也说明它还没磨平。想拿它当生产工具，做好跟着更新走的准备。

十五个入口，其实是五块

侧栏从上往下数十五项：新建对话、搜索、对话列表、邮件、工具、Brain、日历、对比、Cookbook、深度研究、图库、资料库、笔记、任务、主题。第一眼看很唬人，按 README 的模块划分归一下，其实就是五块。

 

第一块是对话和代理。可以接本地模型，也可以接 API 模型；给它工具、MCP、文件读写、命令、技能和记忆，它就按代理的方式干活，不是只回你文字的聊天框。输入框右下角有个 Agent / Chat 开关，选哪个它就走哪条路。

第二块是 Cookbook，我最感兴趣的一个。它先看你机器的硬件，再告诉你该下哪个模型、多大参数、能不能跑起来，然后自己负责下载和托管。等于把「我到底该装哪个」这件最劝退的事接过去了。

第三块是研究和对比。深度研究会自己多步联网、打开原始来源读、最后出报告；对比是盲测，两个模型并排答同一道题，你选完它再告诉你哪个是哪个——这个设计比直接标名字公平得多。

第四块是文档和图库。编辑器是「写作优先」的，支持 Markdown、HTML、CSV 和语法高亮，AI 改写和建议都在里面；图库带一个简单的图片编辑器，生成图、截图往里丢就行。

第五块是个人事务。邮件走 IMAP/SMTP，收进来能自动分诊、打标签、出摘要、提提醒、起草回复；笔记、任务、日历是一套的，日历还能和 CalDAV 双向同步，手机上的日历照样能看到。任务可以定时交给代理去跑。

底下还压着三个自带的服务：向量库 ChromaDB、搜索代理 SearXNG、推送服务 ntfy。也就是说「联网研究」和「有新消息推给你」这两件事，不依赖任何外部账号，全在你自己的 compose 里。

装一遍，三步

官方推荐 Docker，因为镜像已经打包好，不用你配 Python 环境。三条命令，跟 README 一字不差。

第一个坑就在这个端口上。README 写的是 7011，安装文档从头到尾用的是 7000，端口被占时文档又建议改成 7001——三个数字同时存在于官方文档里。以安装文档的 7000 为准，打不开就把另外两个也试一下，别怀疑自己装错了。

第二个坑藏在原生安装里，而且很阴。安装文档的故障排查第一条写着：如果你同时装了 chromadb-client（那个只走 HTTP 的轻量包）和完整的 chromadb，服务照样能起来，但向量库会静默退化成 HTTP-only 模式然后失败——不报错，只是搜索和记忆悄悄不好用了。解法是先卸掉 chromadb-client，再强制重装完整版。

不想用 Docker 的走源码：Python 3.11 以上，建虚拟环境，pip install -r requirements.txt，跑一次 python setup.py，最后用 uvicorn 起在 7000。Cookbook 下载模型要有 tmux，少装这个，后台下载会断。

M 系列 Mac 有个例外：Docker 摸不到 Metal，Cookbook 只能拿 CPU 跑模型。想在 Mac 上用 GPU，别用容器，跑官方的 ./start-macos.sh，它起在 7860。

手机上也能开

它是个网页，所以只要把绑定的地址从 127.0.0.1 改成 0.0.0.0，局域网或 Tailscale 里就能用手机开。官方文档专门提醒：绑定到回环之外之前，务必确认 AUTH_ENABLED=true，更不要把端口直接甩到公网。

 

窄屏这件事它做得比多数自托管项目认真：笔记、任务、日历在手机上不是勉强能看，是真按手机排过版。我看到的手机截图里，顶部是标签筛选，下面一条条笔记带引用标签，加待办的输入框就在最上面一行。

有些限制得先说

第一条是协议。AGPL-3.0-or-later 不是「拿来随便改改就能闭源卖」的许可。你自己用、团队内部用都没问题；但如果你改过它，又把它当成对外提供的网络服务，那义务就跟着来了。商用前先看一眼 LICENSE，别等做完了才想起来。

第二条是权限，官方文档里那句话我原样翻过来：

它带 shell、文件上传、模型下载、联网研究、邮件和日历集成、API token；请把它当作一台管理控制台来对待。—— Odysseus 安装文档 · Security Notes

这不是客套。它默认给代理开文件读写和命令执行，装在一个能碰到你所有文件的位置上，风险自己担。文档给的默认值是对的：AUTH_ENABLED=true 保持开启，LOCALHOST_BYPASS=false 别只在开发时关，起完第一件事是去 data/auth.json 把开放注册关掉，只留自己一个管理员。

第三条是版本。它没有走 GitHub Release 那套，靠容器镜像发版：:latest 和 :1.0.2 这种号会跟着 main 分支重新推，同一个 tag 今天和下周不是一个东西。要长期跑，用带提交号的那种 :1.0.2-7c8070f，一个号永远是一份构建。

第四条是分支。默认分支是 dev，最新改动先落在那儿，也可能带着没改完的东西。图稳就切 main。

第五条是备份，也是最容易漏的。.env、data/、模型权重全是你自己的东西，容器一重建，没备份就全没。文档里也提醒，data/ 千万别提交进 Git。

第六条，PDF 预览和 Office 抽取这些 extras 要另外构建镜像才有，顺手把 AGPL 的 PyMuPDF 也带了进来。不需要就别开，镜像能小一圈。

最后聊聊

它不适合所有人。只想要一个聊天界面的人，用官方 App 更省事；机器只有 8G 内存还想跑本地大模型的，Cookbook 会如实告诉你跑不动；想把数据挂到公网上给团队用的，安全那几条得先过关。

但如果你本来就有一台常开的机器，又攒了一堆「AI 一个 / 笔记一个 / 邮件一个 / 日历一个」的账号，这套东西的价值在于把它们放在同一个入口、同一份数据目录里。尤其邮件和日历这两块，多数 AI 工具根本碰不到，它直接做进去了。

照旧交代一句：这篇我没真装。所有能力都是从 README 和那七百行安装文档里一条条核出来的，数字截至 2026 年 10 月 25 日。装完的手感，得你自己跑一遍。

开源地址

📎 GitHub 地址：https://github.com/odysseus-dev/odysseus

欢迎关注小渔的屋子，只写能上手用的开源工具。

项目信息取自 Odysseus 官方 README 与安装文档（website/setup.md），Stargazers 等数据截至 2026-10-25。