Update nexus: fix conflicts and sync local changes
This commit is contained in:
Shen Wei
@@ -1,115 +1,115 @@
|
||||
---
|
||||
title: "Portainer"
|
||||
tags: [docker, container, management, web-ui]
|
||||
date: 2026-04-22
|
||||
---
|
||||
|
||||
# Portainer
|
||||
|
||||
## Description
|
||||
Portainer 是一个开源的 Docker 和 Kubernetes 可视化管理工具，通过 Web UI 简化容器、镜像、卷、网络、配置的日常运维操作。Community Edition（CE）免费开源，BE（Business Edition）提供额外安全和企业功能。
|
||||
|
||||
## Versions
|
||||
- **Portainer CE**（社区版）：免费开源，通过 `portainer/portainer-ce:lts` 镜像部署
|
||||
- **Portainer BE**（商业版）：面向企业，支持 RBAC、审计日志、团队管理等
|
||||
|
||||
## Deployment
|
||||
```yaml
|
||||
services:
|
||||
portainer:
|
||||
image: portainer/portainer-ce:lts
|
||||
container_name: portainer
|
||||
restart: unless-stopped
|
||||
ports:
|
||||
- "9443:9443" # HTTPS API
|
||||
- "8000:8000" # Edge Agent
|
||||
volumes:
|
||||
- /var/run/docker.sock:/var/run/docker.sock
|
||||
- portainer_data:/data
|
||||
volumes:
|
||||
portainer_data:
|
||||
```
|
||||
|
||||
## Key Ports
|
||||
| 端口 | 用途 |
|
||||
|------|------|
|
||||
| 9443 | HTTPS 管理 API（Web UI） |
|
||||
| 8000 | Edge Agent 通信端口 |
|
||||
|
||||
## Key Concepts
|
||||
|
||||
### Volume
|
||||
Portainer 的 `portainer_data` 卷存储所有持久化数据：
|
||||
- 用户账户和认证信息
|
||||
- 环境配置和设置
|
||||
- Edge Agent 连接信息
|
||||
- 团队和角色定义（BE 版）
|
||||
|
||||
**删除该卷会永久丢失所有数据**，重装前务必确认是否需要保留。
|
||||
|
||||
### Network
|
||||
Portainer 默认创建 `portainer_network` bridge 网络（或类似名称），供 Agent 和 Core 通信。
|
||||
|
||||
### 重装流程
|
||||
当需要重新部署 Portainer 时，必须先清理旧资源，否则会产生警告：
|
||||
```bash
|
||||
# 1. 查找容器
|
||||
docker ps -a | grep portainer
|
||||
|
||||
# 2. 停止并删除旧容器
|
||||
docker stop portainer && docker rm portainer
|
||||
|
||||
# 3. 查看旧卷（可选）
|
||||
docker volume ls | grep portainer
|
||||
|
||||
# 4. 如需保留数据，不删卷；如需全新开始，删卷
|
||||
docker volume rm portainer_data
|
||||
|
||||
# 5. 查看旧网络（可选）
|
||||
docker network ls | grep portainer
|
||||
|
||||
# 6. 如需重建，删旧网络
|
||||
docker network rm portainer_network
|
||||
|
||||
# 7. 重新启动
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
### External Mode（数据保留重装）
|
||||
若需保留现有配置和数据，在 compose 文件中声明：
|
||||
```yaml
|
||||
volumes:
|
||||
portainer_data:
|
||||
external: true
|
||||
networks:
|
||||
portainer_network:
|
||||
external: true
|
||||
```
|
||||
这样 `docker compose up` 不会尝试创建同名卷/网络，而是直接复用已存在的。
|
||||
|
||||
## Common Warnings
|
||||
|
||||
### WARN 1: Network 已存在但不是当前项目创建
|
||||
**原因**：之前的 compose 文件（或不同项目名）已创建了同名网络。
|
||||
**解决**：在 compose 中声明 `external: true` 复用，或删除旧网络后重建。
|
||||
|
||||
### WARN 2: Volume 已存在但属于另一个 compose 项目
|
||||
**原因**：使用不同项目名部署过 Portainer，遗留了旧卷。
|
||||
**解决**：同上。
|
||||
|
||||
## Alternatives
|
||||
- **CLI 工具**：`docker ps`、`docker volume ls`、`docker network ls` 等命令行管理
|
||||
- **LazyDocker**：终端 TUI 工具
|
||||
- **DockStation**：桌面应用
|
||||
|
||||
## Related Concepts
|
||||
- [[Docker]] — Portainer 管理的底层容器化平台
|
||||
- [[Docker Compose]] — Portainer 的推荐部署方式
|
||||
- [[Docker卷]] — Portainer 的持久化存储
|
||||
- [[Docker Network]] — Portainer 的网络连接
|
||||
- [[external配置]] — compose 中复用外部资源的机制
|
||||
|
||||
## Related Entities
|
||||
- [[LinuxServer.io]] — 开源 Docker 镜像维护组织（Portainer 是独立组织）
|
||||
- [[群晖 NAS]] — Portainer 常见的部署平台
|
||||
- [[Docker]] — Portainer 管理的核心对象
|
||||
---
|
||||
title: "Portainer"
|
||||
tags: [docker, container, management, web-ui]
|
||||
date: 2026-04-22
|
||||
---
|
||||
|
||||
# Portainer
|
||||
|
||||
## Description
|
||||
Portainer 是一个开源的 Docker 和 Kubernetes 可视化管理工具，通过 Web UI 简化容器、镜像、卷、网络、配置的日常运维操作。Community Edition（CE）免费开源，BE（Business Edition）提供额外安全和企业功能。
|
||||
|
||||
## Versions
|
||||
- **Portainer CE**（社区版）：免费开源，通过 `portainer/portainer-ce:lts` 镜像部署
|
||||
- **Portainer BE**（商业版）：面向企业，支持 RBAC、审计日志、团队管理等
|
||||
|
||||
## Deployment
|
||||
```yaml
|
||||
services:
|
||||
portainer:
|
||||
image: portainer/portainer-ce:lts
|
||||
container_name: portainer
|
||||
restart: unless-stopped
|
||||
ports:
|
||||
- "9443:9443" # HTTPS API
|
||||
- "8000:8000" # Edge Agent
|
||||
volumes:
|
||||
- /var/run/docker.sock:/var/run/docker.sock
|
||||
- portainer_data:/data
|
||||
volumes:
|
||||
portainer_data:
|
||||
```
|
||||
|
||||
## Key Ports
|
||||
| 端口 | 用途 |
|
||||
|------|------|
|
||||
| 9443 | HTTPS 管理 API（Web UI） |
|
||||
| 8000 | Edge Agent 通信端口 |
|
||||
|
||||
## Key Concepts
|
||||
|
||||
### Volume
|
||||
Portainer 的 `portainer_data` 卷存储所有持久化数据：
|
||||
- 用户账户和认证信息
|
||||
- 环境配置和设置
|
||||
- Edge Agent 连接信息
|
||||
- 团队和角色定义（BE 版）
|
||||
|
||||
**删除该卷会永久丢失所有数据**，重装前务必确认是否需要保留。
|
||||
|
||||
### Network
|
||||
Portainer 默认创建 `portainer_network` bridge 网络（或类似名称），供 Agent 和 Core 通信。
|
||||
|
||||
### 重装流程
|
||||
当需要重新部署 Portainer 时，必须先清理旧资源，否则会产生警告：
|
||||
```bash
|
||||
# 1. 查找容器
|
||||
docker ps -a | grep portainer
|
||||
|
||||
# 2. 停止并删除旧容器
|
||||
docker stop portainer && docker rm portainer
|
||||
|
||||
# 3. 查看旧卷（可选）
|
||||
docker volume ls | grep portainer
|
||||
|
||||
# 4. 如需保留数据，不删卷；如需全新开始，删卷
|
||||
docker volume rm portainer_data
|
||||
|
||||
# 5. 查看旧网络（可选）
|
||||
docker network ls | grep portainer
|
||||
|
||||
# 6. 如需重建，删旧网络
|
||||
docker network rm portainer_network
|
||||
|
||||
# 7. 重新启动
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
### External Mode（数据保留重装）
|
||||
若需保留现有配置和数据，在 compose 文件中声明：
|
||||
```yaml
|
||||
volumes:
|
||||
portainer_data:
|
||||
external: true
|
||||
networks:
|
||||
portainer_network:
|
||||
external: true
|
||||
```
|
||||
这样 `docker compose up` 不会尝试创建同名卷/网络，而是直接复用已存在的。
|
||||
|
||||
## Common Warnings
|
||||
|
||||
### WARN 1: Network 已存在但不是当前项目创建
|
||||
**原因**：之前的 compose 文件（或不同项目名）已创建了同名网络。
|
||||
**解决**：在 compose 中声明 `external: true` 复用，或删除旧网络后重建。
|
||||
|
||||
### WARN 2: Volume 已存在但属于另一个 compose 项目
|
||||
**原因**：使用不同项目名部署过 Portainer，遗留了旧卷。
|
||||
**解决**：同上。
|
||||
|
||||
## Alternatives
|
||||
- **CLI 工具**：`docker ps`、`docker volume ls`、`docker network ls` 等命令行管理
|
||||
- **LazyDocker**：终端 TUI 工具
|
||||
- **DockStation**：桌面应用
|
||||
|
||||
## Related Concepts
|
||||
- [[Docker]] — Portainer 管理的底层容器化平台
|
||||
- [[Docker Compose]] — Portainer 的推荐部署方式
|
||||
- [[Docker卷]] — Portainer 的持久化存储
|
||||
- [[Docker Network]] — Portainer 的网络连接
|
||||
- [[external配置]] — compose 中复用外部资源的机制
|
||||
|
||||
## Related Entities
|
||||
- [[LinuxServer.io]] — 开源 Docker 镜像维护组织（Portainer 是独立组织）
|
||||
- [[群晖 NAS]] — Portainer 常见的部署平台
|
||||
- [[Docker]] — Portainer 管理的核心对象
|
||||
|
||||
Reference in New Issue
Block a user