self-host：自托管应用部署 CLI

项目简介

self-host 是一个 Go 编写的命令行工具，面向家庭服务器、homelab 用户和 AI 代理。它通过 Docker Compose 安装、配置、连接和维护自托管应用，目标是让用户用一个二进制运行自己的应用，减少对 SaaS 的依赖，并且不需要深入的 Docker 知识。人和代理可以共用 ~/.self-host 中的同一个 Project。仓库还包含 DCM（Docker Compose Maker），可在浏览器中生成 docker-compose.yaml 和 .env。

主要功能

• 应用安装与配置：从应用目录中选择应用，执行安装和初始化配置；在支持的情况下创建账号与 API key。
• Links 与维护：把应用连接起来，并提供备份、诊断和状态检查。
• 终端 Dashboard：直接在终端查看应用状态和需要处理的事项。
• AI 代理协作：为 Claude Code、Codex、OpenCode、Pi、Hermes Agent、OpenClaw 等代理提供技能；支持用 --json 输出结构化数据。
• DCM Compose 构建器：在 self-host.fyi/compose 选择容器或模板，调整配置后导出 Compose 与 .env 文件。

安装与使用

环境要求：Linux、macOS 或 WSL2，并安装带 Compose v2 插件的 Docker。

安装二进制：

curl -fsSL https://self-host.fyi/install | bash

安装脚本只安装二进制，不会直接部署任何应用。之后运行：

self-host

让本机代理发现 self-host 技能：

self-host skill install

代理可先检查再执行，例如：

self-host status --json
self-host apps list --json
self-host install ntfy --exposure local --yes --json

最后一条命令应在用户明确批准后再运行。

本地运行 DCM：

docker run --rm -p 127.0.0.1:7576:7576 ghcr.io/ajnart/dcm

然后打开 http://localhost:7576/compose/。

注意事项

• 安装脚本需要 Bash；Windows 用户需通过 WSL2 使用。
• 代理操作遵循“检查 → 计划 → 批准 → 执行 → 验证”，加载技能不等于获得变更授权。
• 密钥用 --set-file app.key=/path 传入，不要写在命令行参数中；它们会写入 Project 私有的 .env 文件（权限 0600）。
• 容器正在运行或返回 HTTP 200 并不等于应用可用，需要确认应用实际完成工作。
• 更多说明见 官方文档。

---

本作品整理自 GitHub 开源项目 ajnart/self-host，原作者 @ajnart，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。