第一个容器：部署 pgAdmin 4

本文以 pgAdmin 4 为例，演示如何通过 AcePanel 快速部署 Docker 容器。

安装 Docker

前往「应用」页面，在「原生应用」标签页中找到 Docker 并安装。 安装进度可在「任务」->「面板任务」中查看。

国内服务器

国内服务器拉取镜像较慢， 建议配置 毫秒镜像 提供的付费加速源。

部署容器

前往「应用」->「容器模板」，找到 pgAdmin 4，点击「部署」。 部署是一个四步向导：部署模式、配置、预览与编辑、确认。

在模板列表中，你可以通过顶部的分类标签或右侧的搜索框来缩小选择范围。 每个模板卡片都会显示其图标、名称和描述；「本地」标签标记存储在本服务器上的模板（而非从远程模板仓库获取的），定义了主页的模板会显示一个外链按钮，点击即可打开项目网站。

在「部署模式」步骤中，选择「创建新编排」（另一个选项「更新现有编排」则是将模板应用到已有的编排上）。

在「配置」步骤中，填写配置：

• 编排名称：给编排起个名字，如 pg4admin
• 自动启动：勾选后创建完成自动拉取镜像并启动
• 自动防火墙：勾选后自动放行编排中定义的端口
• 访问端口：容器 80 端口映射到主机端口，如 999
• 管理员邮箱/密码：pgAdmin 4 的登录凭据

「环境变量」分隔线下方的字段（访问端口、管理员邮箱、管理员密码等） 来自模板的环境变量，因模板而异。 每个变量都会渲染为与其声明类型相匹配的输入框：

类型	显示的输入框	说明
text	纯文本输入框	默认类型
password	密码输入框（点击可显示）	用于管理员密码等机密信息
number	数字输入框	仅限数字
port	限制为 1-65535 的数字输入框	用于访问端口等主机端口映射
url	文本输入框	会校验是否为格式正确的 URL
select	下拉框	从模板提供的选项中选择

模板未定义默认值的字段均为必填项，必须填写后才能继续；有默认值的字段可留空以保留该默认值。

点击「下一步」进入「预览与编辑」步骤。 此步骤有两个标签页：

• 编排文件：显示最终 docker-compose.yml 的 YAML 编辑器。 你可以在部署前手动微调它。
• 环境变量：列出将要写入的每个变量的键值编辑器。 你可以在此添加、编辑或删除条目。

再次点击「下一步」进入「确认」步骤。 它会显示你所选内容的摘要（部署模式、编排名称、自动启动、自动防火墙以及环境变量数量），以及一个可折叠的只读最终编排内容预览。 点击「创建」以确认。

更新现有编排

在第一步中，你也可以选择「更新现有编排」，将模板应用到服务器上已存在的编排。 流程同样是四个步骤，但有几处不同：

• 在「配置」步骤中，你从一个可搜索的下拉框中选择目标编排，而不是输入新名称。 随后表单会自动填入该编排现有的环境变量值，因此你只需调整有变化的部分。
• 「预览与编辑」步骤会显示一个差异编辑器：左侧是原始编排，右侧是新编排（可编辑），让你能清楚地看到模板将要更改的内容。
• 「确认」按钮显示为「更新」而非「创建」，且此模式下不显示自动防火墙选项。

等待启动

若勾选了「自动启动」，创建完成后会弹出一个终端窗口并运行 docker compose ... up -d，实时输出镜像拉取和启动进度：

若未勾选「自动启动」，则尚未拉取任何镜像。 前往「容器」->「编排」页面，在那里启动编排。

也可以在「容器」->「编排」页面手动管理：

访问服务

启动完成后，浏览器访问 http://服务器IP:端口（如 http://x.x.x.x:999），用之前设置的邮箱和密码登录即可。