进阶 docs.pangolin.net 2026-11-21 15:06:37 · 2 阅读

第14章 Pangolin 快速安装指南:部署自托管社区版实例

快速安装指南

部署你自己的 Pangolin 社区版全自托管实例

前提条件 开始之前,请确保你已具备:

- 拥有 root 权限和公网 IP 的 Linux 服务器 - 已将域名解析到服务器 IP,用于访问控制面板 - 用于申请 Let's Encrypt SSL 证书和管理员登录的邮箱 - 防火墙已开放端口:80(TCP)、443(TCP)、51820(UDP)以及 21820(UDP,供客户端使用)

建议使用 Ubuntu 20.04+ 或 Debian 11+,兼容性和性能最佳。

选择服务器 不知道怎么选?请参考我们的完整 VPS 指南获取建议。

DNS 与网络 安装 Pangolin 之前,请确保已为域名配置好 DNS,并在防火墙开放所需端口。详情参见 DNS 与网络指南。

安装流程

1. 下载安装器 通过 SSH 连接到服务器并下载安装器:

curl -fsSL https://static.pangolin.net/get-installer.sh | bash

安装器同时支持 AMD64(x86_64)和 ARM64 架构。

2. 运行安装器 以 root 权限执行安装器:

sudo ./installer

安装器会把所有文件放在当前目录。运行前请先把它移到你想要的安装目录。

3. 配置基础设置 安装器会提示你填写以下必要配置:

- 版本:选择社区版或企业版。继续之前请先了解两个版本的差异。 - 基础域名:输入不带子域名的一级域名(如 example.com) - 控制面板域名:按回车接受默认的 pangolin.example.com,或输入自定义域名 - Let's Encrypt 邮箱:填写用于 SSL 证书和管理员登录的邮箱 - 隧道:选择是否安装 Gerbil 用于隧道连接(默认:是)。也可以不使用隧道功能,此时 Pangolin 作为一个普通的反向代理运行。

4. 配置邮件(可选) 邮件功能是可选的,之后也能随时添加。

选择是否启用 SMTP 邮件功能:

- 默认:不启用(初次安装推荐) - 若启用:需要提供 SMTP 服务器信息(主机、端口、用户名、密码)

5. 开始安装 确认安装并启动容器:

- 安装器会拉取 Docker 镜像(pangolin、gerbil、traefik) - 容器会自动启动 - 整个过程约需 2-3 分钟,取决于你的网络状况

每个容器拉取和启动时都会显示进度提示。

安装后设置 安装成功后,你会看到:

Installation complete!

To complete the initial setup, please visit: https:///auth/initial-setup

访问控制面板 打开安装器输出中的 URL,输入安装器显示的设置令牌。如果安装时没有启动容器,可以在 Pangolin 容器首次启动时从其日志中获取令牌。

https:///auth/initial-setup

控制面板加载时 SSL 证书已自动配置好。首次证书验证可能需要几分钟,浏览器提示不安全警告时不必担心。

从 Pangolin 日志获取设置令牌 查看 Pangolin 容器日志,复制打印到 stdout 的设置令牌:

sudo docker compose logs pangolin

在初始设置页面需要用到这个令牌来注册第一个管理员账号。

创建管理员账号 完成初始管理员设置:

- 粘贴来自 Pangolin 日志的设置令牌 - 输入管理员邮箱 - 设置强密码 - 验证邮箱(如已配置邮件功能)

请为管理员账号使用强且唯一的密码,该账号拥有系统的完整权限。

创建第一个组织 登录后:

- 输入组织名称和描述 - 点击"Create Organization"

现在就可以开始添加应用、配置反向代理了!

这个页面有帮助吗?

评论 (0)