第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://
访问控制面板 打开安装器输出中的 URL,输入安装器显示的设置令牌。如果安装时没有启动容器,可以在 Pangolin 容器首次启动时从其日志中获取令牌。
https://
控制面板加载时 SSL 证书已自动配置好。首次证书验证可能需要几分钟,浏览器提示不安全警告时不必担心。
从 Pangolin 日志获取设置令牌 查看 Pangolin 容器日志,复制打印到 stdout 的设置令牌:
sudo docker compose logs pangolin
在初始设置页面需要用到这个令牌来注册第一个管理员账号。
创建管理员账号 完成初始管理员设置:
- 粘贴来自 Pangolin 日志的设置令牌 - 输入管理员邮箱 - 设置强密码 - 验证邮箱(如已配置邮件功能)
请为管理员账号使用强且唯一的密码,该账号拥有系统的完整权限。
创建第一个组织 登录后:
- 输入组织名称和描述 - 点击"Create Organization"
现在就可以开始添加应用、配置反向代理了!
这个页面有帮助吗?