Docker Compose 示例合集：自托管服务一键部署

搞自托管的人都知道，最头疼的不是选软件，是部署。每个项目的 Docker Compose 写法都不一样，光是调通一个服务就得翻半天文档。Haxxnet 维护的这个 Compose-Examples 仓库，就是专门解决这个问题的。

这个项目收集了上百个 Docker Compose 配置文件，覆盖了自托管场景下的主流需求。从个人仪表盘、密码管理器，到 VPN、DNS、AI 模型部署，基本上你能想到的服务类型都有现成的 Compose 文件可以直接用。

项目结构

仓库的组织方式很清晰。所有 Compose 文件都放在 examples 目录下，每个服务一个子文件夹。进去之后就是标准的 docker-compose.yml，有些还附带了配置文件模板和使用说明。

比如你想搭个 Vaultwarden（Bitwarden 的轻量替代），不用去官方文档里找部署指南，直接进 examples/vaultwarden 目录，把 Compose 文件拉下来，改改端口和路径，docker compose up 就完事了。

覆盖范围

看了一遍目录，涵盖的服务类型确实不少：

个人仪表盘类有 Homepage、Homer、Dashy、Homarr、Flame、Heimdall 这些。密码管理有 Vaultwarden、Bitwarden Unified、Passbolt。反向代理支持 Traefik、Nginx Proxy Manager、Caddy。身份认证方面有 Authelia、Authentik、Keycloak、ZITADEL、Casdoor、lldap。

DNS 相关的有 AdGuard Home、Technitium DNS、Pi-hole、Cloudflare DDNS。VPN 和远程访问覆盖了 WireGuard、wg-easy、IPSec、OpenVPN、Firezone、Headscale、Guacamole。

开发工具也不少，Gitea、Forgejo、Gitlab Community、Code-Server、Drone、Onedev、Jira Core 都有。自动化和监控方面有 n8n、Home Assistant、Portainer、Dockge、Uptime Kuma、Grafana 全家桶、Watchtower、Beszel。

还有文件同步、电商、博客、笔记、图库、食谱管理等类别，总数加起来超过一百个项目。

使用方式

使用方法很直接。克隆仓库，进入 examples 目录，找到你需要的服务文件夹。每个 Compose 文件都假设 volume 挂载在 /mnt/docker-volumes/<容器名>/ 路径下，你可以通过 DOCKER_VOLUME_STORAGE 环境变量改成自己的路径。

有几个注意事项。Volume 权限（UID:GID）需要自己设置，一般是 1000:1000。Docker 网络没有预定义，需要根据自己的代理和网络环境调整。示例配置文件通常提供了，但没有放到正确的挂载路径下，需要手动处理。默认密码一定要改，建议放到 .env 文件或者专门的密钥管理平台里。

实际操作就是三步：git clone，cd 到对应目录，docker compose up。中间可能需要改改路径、端口、密码之类的参数，但比从零写 Compose 文件省事多了。

适合谁用

这个项目主要面向两类人。

第一类是自托管爱好者。如果你想在自己的服务器上跑一堆服务，但不想花时间研究每个项目的部署文档，这个仓库能省掉大量时间。基本上所有主流自托管项目都有现成的 Compose 配置。

第二类是想快速搭建开发环境的人。比如你需要一套完整的 CI/CD 环境（Gitea + Drone），或者一套监控栈（Grafana + Loki + Promtail），不用一个个去配，直接拿现成的 Compose 文件改改就能用。

几个实际建议

虽然这些 Compose 文件可以直接用，但不建议直接扔到生产环境。README 里也说了，这些示例主要是给本地开发和测试用的。如果要部署到公网，需要做安全加固：改默认密码、配置 HTTPS、设置备份策略、用反向代理统一管理。

另外，有些服务的 Compose 文件可能不是最新版本。如果遇到问题，先检查一下镜像版本，可能需要手动更新。

还有一个在线网页版可以浏览所有项目，不用克隆仓库就能查看各个服务的 Compose 配置。

总体评价

这个仓库的价值在于"省时间"。自托管的门槛主要在部署环节，有了现成的 Compose 文件，很多服务真的可以做到一键启动。项目维护得也不错，有 CI 验证、有社区贡献，7000 多个 Star 说明确实帮到了不少人。

如果你正在搞自托管，或者打算开始折腾，这个仓库值得收藏。不用每个都试，按需取用就行。

说明确实帮到了不少人。

如果你正在搞自托管，或者打算开始折腾，这个仓库值得收藏。不用每个都试，按需取用就行。