moltis

环境要求

• 已安装 Docker 或 OrbStack（镜像支持 amd64 / arm64）
• 能访问 ghcr.io 拉取镜像
• 挂载 /var/run/docker.sock 以供沙箱执行使用
• 源码构建方式额外需要 just 命令运行器与 Node.js（用于 Tailwind CSS）
• 云部署需要 fly CLI 或 DigitalOcean 账号

安装与启动步骤

1. 1拉取镜像

   从 GitHub Container Registry 拉取最新多架构镜像，支持 amd64 与 arm64。

   docker pull ghcr.io/moltis-org/moltis:latest

   复制

2. 2启动容器

   映射 13131/13132/1455 端口，挂载配置卷、数据卷与 Docker socket。

   docker run -d \
     --name moltis \
     -p 13131:13131 \
     -p 13132:13132 \
     -p 1455:1455 \
     -v moltis-config:/home/moltis/.config/moltis \
     -v moltis-data:/home/moltis/.moltis \
     -v /var/run/docker.sock:/var/run/docker.sock \
     ghcr.io/moltis-org/moltis:latest

   复制

3. 3访问 Web 界面

   浏览器打开 https://localhost:13131 进入 Web UI 完成后续设置。

4. 4完成初始化

   首次启动会打印 setup code（见容器日志），在 Web UI 输入以设置密码或注册 passkey。

5. 5脚本安装备选

   macOS / Linux 可直接运行官方一键安装脚本，无需 Docker。

   curl -fsSL https://www.moltis.org/install.sh | sh

   复制

6. 6源码构建运行

   需先装 just 与 Node.js；依次构建 CSS 与 release 二进制后启动。

   git clone https://github.com/moltis-org/moltis.git
   cd moltis
   just build-css
   just build-release
   cargo run --release --bin moltis

   复制

7. 7云平台部署

   Fly.io 用官方镜像启动，并用 secrets 写入密码；云配置需加 --no-tls。

   fly launch --image ghcr.io/moltis-org/moltis:latest
   fly secrets set MOLTIS_PASSWORD="your-password"

   复制

关键配置

如何确认成功

浏览器能打开 https://localhost:13131（源码运行则是 https://moltis.localhost:3000）并出现设置页面，即启动成功。

常见问题

注意事项

• 你的密钥不会离开本机，所有命令都在沙箱容器中执行，而非宿主机。
• 容器挂载了宿主机的 /var/run/docker.sock，请确认该权限带来的安全影响后再部署。
• 一键脚本通过 curl | sh 直接执行网络脚本，建议先核实来源内容。
• 生产环境建议按官方文档自行补充 Podman、OrbStack、TLS 信任与持久化细节。