返回 Milo 首页

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。生产验收和独立安全审查仍未完成。
了解隐私边界