---
title: "用Docker安装Portainer"
type: source
tags: [docker, portainer]
date: 2026-04-14
---

## Source File
- [[raw/Home Office/用Docker安装Portainer.md]]

## Summary (用中文描述)
- **核心主题**：通过 Docker Compose 在 Home Server 上部署 Portainer 容器管理 Web UI
- **问题域**：家庭服务器 Docker 容器运维管理
- **方法/机制**：使用 docker-compose.yml 定义 Portainer 服务，通过 Docker socket 直通实现宿主机 Docker 守护进程的 Web 可视化管理
- **结论/价值**：提供图形化界面管理 Docker 容器/镜像/卷/网络，降低命令行运维门槛

## Key Claims (用中文描述)
- **Portainer** 通过 `docker.sock` 挂载实现对宿主机 Docker 守护进程的完整访问控制
- 使用 **portainer/portainer-ce:lts** 镜像部署 Portainer Community Edition 长期支持版
- 配置 `restart: always` 确保容器在宿主机重启后自动恢复
- 映射端口 `9443:9443` 提供 HTTPS API Web 界面，`8000:8000` 支持 Edge Agent 通信
- 持久化数据存储在 Docker 卷 `portainer_data:/data`

## Key Quotes
> "create docker-compose.yml" — 部署起点，docker-compose 是 Portainer 部署的标准方式

> "`docker-compose run -d`" — 容器启动命令，后台守护模式运行

## Key Concepts
- [[Docker可视化管理工具]]：提供 Web UI 替代命令行管理 Docker 容器、镜像、卷、网络
- [[Docker Socket]]：`/var/run/docker.sock` 是 Docker 守护进程的 Unix socket，挂载到容器内实现特权访问
- [[Docker卷]]：`portainer_data` Docker 卷用于持久化 Portainer 自身数据（配置、密码等）

## Key Entities
- [[Portainer]]：开源 Docker 可视化管理工具，提供 Web UI 管理容器/镜像/卷/网络
- [[Portainer CE LTS]]：Portainer Community Edition 长期支持版本

## Connections
- [[Portainer]] ← 依赖 ← [[Docker Engine]]（宿主机 Docker 守护进程）
- [[Portainer]] ← 使用 ← [[Docker Socket]]（socket 直通实现特权访问）
- [[Portainer]] ← 存储数据在 ← [[Docker卷]]（portainer_data 卷）
- [[Portainer]] ← 属于 ← [[Docker可视化管理工具]]（替代命令行运维）

## Contradictions
- 无冲突

## Related Sources
- [[用docker安装transmission]] — 同属 Home Office Docker 部署系列
- [[用docker安装jellyfin]] — 同属 Home Office Docker 部署系列
- [[用docker安装navidrome]] — 同属 Home Office Docker 部署系列