Portainer 深度指南：企业级 Docker 管理

虽然群晖自带了 Container Manager，但 Portainer 依然是进阶玩家的必备工具。它提供了更强大的 Stacks (GitOps)、App Templates、Edge Agent 等功能，让你像管理企业集群一样管理 NAS。

1. Stacks：GitOps 自动部署

这是 Portainer 最核心的功能。你可以直接把 Docker Compose 文件放在 GitHub/Gitea 仓库里，Portainer 自动拉取并部署。修改代码 -> 提交 Git -> 容器自动更新。

准备 Git 仓库：在 GitHub 上创建一个私有仓库，上传 docker-compose.yml。
Portainer > Stacks > Add stack。
Build method: 选择 Repository。
Repository URL: https://github.com/yourname/nas-docker.git。
Repository reference: refs/heads/main。
Authentication: 如果是私有仓库，开启并输入 GitHub Token。
Automatic updates: 开启。
- Fetch interval: 5m (每 5 分钟检查一次)。
- Force redeployment: 开启（Git 变动时自动重建容器）。
点击 Deploy the stack。

从此，你只需要在电脑上修改 Git 仓库里的配置，NAS 上的容器就会自动同步更新。

Portainer 允许你添加第三方模板源，实现“一键部署”。

Settings > App Templates。
URL: 输入第三方模板地址。
- 推荐（Lissy93）：https://raw.githubusercontent.com/Lissy93/portainer-templates/main/templates.json
- 推荐（Technorabilia）：https://raw.githubusercontent.com/technorabilia/portainer-templates/main/lsio/templates.json
保存。
回到 App Templates 页面，你会发现多了几百个应用（如 Plex, Radarr, Home Assistant）。点击即装，无需手写 Compose。

在多个容器中复用同一个密码或 Token？

在 Compose 文件中引用：

environment:
  - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD}

如果你有另一台 NAS 或 VPS，可以在 Portainer 中统一管理。

Portainer 为了安全，启动后 5 分钟如果不创建管理员，会自动关闭注册通道。 * 重置方法：使用 portainer/helper-reset-password 镜像。

docker stop portainer
docker run --rm -v /volume1/docker/portainer:/data portainer/helper-reset-password
docker start portainer

查看输出日志获取新密码。