MILO / 自托管指南
你的服务器,你的一方天地。
让 Milo 运行在你选择的基础设施上。同样熟悉的对话,数据的家由你掌握。
你将运行什么
仓库提供 Bun / Hono API、PostgreSQL、Redis、私有附件存储和独立的 SvelteKit 管理后台。Flutter 原生客户端通过 HTTPS 连接你的 API。
从代码仓库开始
源码仓库目前为私有,自托管需要仓库访问权限;公开安装包无需 GitHub 账号。在 Milo monorepo 中,复制示例环境文件并填写自己的配置。下列命令是本地部署的起点。权限、TLS、签名、备份与生产要求请遵循 docs/deployment.md。
本地部署起点
umask 077
cp .env.example .env
# 请在 .env 中填写你自己的配置。
docker compose up --build -d构建原生客户端
按根目录 README 安装固定版本的 Flutter 和 Rust 工具链。在 apps/client 中,将本地开发构建连接到已经启动的 API。本地 Compose 通过 http://127.0.0.1:8080 提供服务(Android 模拟器使用 http://10.0.2.2:8080),生产构建必须使用 HTTPS。新设备仍需要批准。
在 APPS/CLIENT 中执行
flutter pub get --enforce-lockfile
flutter run --dart-define=MILO_API_URL=https://your-server.example已发布的 Android 和 Windows 安装包可在首页下载区获取;iOS 与 macOS 公开分发尚待签名配置。
部署到生产环境之前
- 配置自己的数据库、Redis、私有存储与管理员密封密钥。
- 在反向代理上配置 HTTPS/WSS;附件必须存放在公开 Web 目录之外。
- 初始化管理员并启用 MFA。安排加密备份和实际恢复演练。
- 阅读 docs/deployment.md 与 docs/implementation-status.md。生产验收和独立安全审查仍未完成。