在香港服务器上安装1Panel面板,如何完成网站首次部署?
第一次部署不必同时搭建数据库、PHP和多个应用。可以先在一台干净的香港服务器上安装1Panel,通过应用商店部署OpenResty,发布一个静态网站,再完成域名解析与HTTPS配置。这样能先验证“服务器网络—面板—Web服务—网站目录—证书”的完整链路,后续接入动态程序时也更容易定位问题。
下面以Ubuntu Server 22.04 LTS、x86_64架构、1Panel v2和静态HTML网站为实施环境,目标是让www.example.com能够通过HTTPS访问,并保留页面回滚能力。示例域名和IP均需替换;界面名称、默认端口和安装目录可能随小版本变化,应以实际安装结果为准。
A5数据为网站首次部署提供中国香港物理服务器资源,覆盖入门建站、Xeon Gold与AMD EPYC等配置,并配备SSD或NVMe存储及CN2、国际带宽等线路选项。针对1Panel管理的网站、后台服务、数据库和容器化应用,A5数据可提供从基础建站到多任务运行的硬件与网络资源,支持香港及跨境业务的服务器部署需求。
一、先确认服务器能够承担这次部署
系统、资源与依赖范围
建议使用尚未承载业务的新服务器。2核CPU、4GB内存可作为本教程的参考起点,不代表网站并发能力承诺;实际资源需求还取决于应用数量、访问量和日志增长情况。
| 对象 | 本次要求 | 检查方式 |
|---|---|---|
| 操作系统 | Ubuntu Server 22.04 LTS,具备root权限 | 查看系统版本与当前用户 |
| 架构 | x86_64 | uname -m返回x86_64 |
| 存储 | 系统盘留有充足空间,建议至少20GB可用空间 | df -h / |
| 管理入口 | SSH可用,并有控制台救援入口 | 保留当前SSH会话 |
| 软件运行环境 | Docker与OpenResty | 安装后检查服务及容器 |
| 域名 | 可修改DNS记录 | 查看权威DNS配置 |
| 公网网络 | 服务器具备可访问的公网地址 | 从服务器外部检查80、443端口 |
静态网站不需要安装PHP、MySQL或Node.js。1Panel负责管理,Docker提供容器运行环境,OpenResty负责读取网站文件并处理HTTP请求,三者职责不要混淆。
登录服务器后执行以下只读检查:
cat /etc/os-release
uname -m
id
free -h
df -h /
timedatectl status
sudo ss -lntp
预期应确认系统版本正确、内存和磁盘空间足够、时间正常。若80或443端口已被其他服务占用,先查清该服务是否正在承载业务,不要直接停止进程。
香港服务器的机房位置不会改变上述安装步骤,但会影响实际访问路径。上线时仍需从目标访问地区测试域名解析、连接建立和页面加载,不能把服务器位置直接等同于所有地区的访问体验。
先做备份,再改网络规则
在服务器管理控制台创建系统盘快照;如果供应商不提供快照,至少备份已有配置与业务文件。A5IDC服务器的公网地址、SSH端口和控制台入口应以实际交付信息为准,不要把示例值当作服务默认值。
首次部署需要处理三类入站规则:
- SSH端口:仅允许运维来源地址,实际端口不一定是22。
- 80、443端口:用于网站访问;HTTP验证申请证书时需要80端口可达。
- 1Panel管理端口:只允许管理员公网IP,不向所有来源开放。
云平台安全组和系统防火墙是两层独立控制,任意一层阻断都会导致访问失败。应先核对安全组,再检查系统规则:
sudo ufw status verbose
若UFW已经启用,可按下面的形式添加规则。以下IP为文档示例,执行前必须替换管理员IP、SSH端口和面板端口:
ADMIN_IP="198.51.100.20"
SSH_PORT="22"
PANEL_PORT="18443"
sudo ufw allow from "$ADMIN_IP" to any port "$SSH_PORT" proto tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow from "$ADMIN_IP" to any port "$PANEL_PORT" proto tcp
sudo ufw status numbered
这里的18443只是准备使用的面板端口,不代表默认端口,也不代表面板已经启用HTTPS。检查它未被占用后,安装时选择同一端口即可。
防火墙调整可能中断远程管理。修改前保存现有规则,保留当前SSH会话,并从第二个终端测试重新登录。UFW原本未启用时,不要只为照抄教程直接启用;应先确认全部管理规则和控制台救援能力。删除错误规则时使用ufw delete撤销对应规则,按编号删除后应重新查看编号,避免误删其他项。
二、安装1Panel,并确认容器环境正常
安装基础工具
以下操作适用于Ubuntu 22.04。更新软件索引和安装工具会修改系统软件包状态;已有业务服务器应安排维护窗口,本教程不执行整机升级。
sudo apt-get update
sudo apt-get install -y ca-certificates curl dnsutils
验证工具能够使用:
curl --version
dig -v
若软件源连接失败,应先检查DNS、系统时间及出站网络。不要为解决一次下载失败,随意替换成来源不明的软件源或安装脚本。
下载并运行安装脚本
安装脚本会以高权限写入文件、创建服务,并可能安装Docker。执行前应确认脚本地址来自1Panel官网的v2安装指引;若官网已调整入口,以对应版本的官方指引为准。
下面采用先下载、检查,再执行的方式:
curl -fL --proto '=https' --tlsv1.2 \
https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh \
-o /tmp/1panel-quick-start.sh
test -s /tmp/1panel-quick-start.sh
bash -n /tmp/1panel-quick-start.sh
cat /tmp/1panel-quick-start.sh
bash -n只检查Shell语法,不能证明脚本安全。阅读脚本可以了解主要执行逻辑;它后续下载的组件也需要来自可信来源。
确认后执行:
sudo bash /tmp/1panel-quick-start.sh
按交互提示设置安装目录、管理端口和管理员信息。若程序自动生成账号信息,登录后及时修改密码。管理入口、安全入口路径和密码应保存到受控的密码管理工具,不要贴入公开工单或文章评论。
安装过程中若提示安装Docker,应确认服务器上没有需要保留的既有Docker环境。不要在已有容器业务的机器上直接替换运行时配置,也不要随意套用不明镜像加速地址。
用服务状态验证安装,而不是只看结束提示
先检查Docker:
sudo systemctl is-active docker
sudo docker version
sudo docker ps
正常情况下,服务状态返回active,docker version能显示客户端与服务端信息。此时没有业务容器也可以是正常情况,因为OpenResty尚未安装。
再查找实际安装的面板服务与管理命令:
systemctl list-units --type=service --all | grep -i 1panel
command -v 1pctl
1Panel v2与旧版本的服务组织方式不同,不应直接套用旧版服务名。对上一步列出的实际服务执行检查,例如:
sudo systemctl status <实际服务名> --no-pager
将尖括号部分替换后再执行。若状态异常,可进一步查看该服务日志:
sudo journalctl -u <实际服务名> -n 100 --no-pager
浏览器访问时应使用安装输出提供的完整入口,包括协议、端口和安全入口路径。首次登录如未配置面板HTTPS,应限制来源IP,并尽快配置安全管理入口;网站证书与面板证书是两个独立对象,给网站启用HTTPS不会自动保护面板登录。
三、先发布页面,再接入域名
从应用商店安装OpenResty
进入1Panel应用商店,安装与当前面板版本兼容的OpenResty。首次部署使用面板提供的常规配置即可:
- 确认HTTP端口为80、HTTPS端口为443。
- 不安装当前网站不需要的数据库或语言运行环境。
- 等待应用状态变为运行中。
- 查看安装日志,确认没有端口冲突或镜像拉取失败。
容器运行状态可以在终端复核:
sudo docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'
应看到OpenResty对应容器处于运行状态,并有80、443端口映射。若只显示容器内部端口,没有主机端口映射,需要检查应用配置;若绑定在127.0.0.1上,也不能直接从公网访问。
注意:Docker发布的容器端口与UFW之间存在规则交互,不能仅凭UFW显示“拒绝”就认定容器端口没有暴露。公网入口应优先通过服务器平台安全组约束,再从外部实际验证。

创建静态网站
在“网站”功能中创建网站,选择静态网站类型,填写www.example.com,关联刚安装的OpenResty。暂时不要添加没有解析、也不准备使用的域名别名。
创建后,在网站设置或文件管理中找到实际网站根目录。以下路径只是常见形式的示例,不能替代界面核对:
SITE_ROOT="/opt/1panel/www/sites/www.example.com/index"
根目录必须与Web服务配置中的目录对应。文件上传到服务器并不等于网站能够读取它;尤其是容器部署,主机路径还需要通过挂载映射给容器。

备份默认首页,再写入测试页面
下面只修改该网站的index.html,不递归调整权限,也不覆盖其他站点。执行前把SITE_ROOT替换成面板显示的实际目录。
SITE_ROOT="/opt/1panel/www/sites/www.example.com/index"
if [ ! -d "$SITE_ROOT" ]; then
echo "网站目录不存在,请重新核对面板中的根目录"
exit 1
fi
BACKUP_DIR="/root/deploy-backups/www.example.com-$(date +%Y%m%d-%H%M%S)"
sudo mkdir -p "$BACKUP_DIR"
if sudo test -f "$SITE_ROOT/index.html"; then
sudo cp -a "$SITE_ROOT/index.html" "$BACKUP_DIR/index.html"
else
sudo touch "$BACKUP_DIR/index-was-absent"
fi
printf '页面备份目录:%s\n' "$BACKUP_DIR"
记录输出的备份目录,后续回滚不能使用重新生成的时间戳。然后生成一个带有辨识标记的页面:
cat > /tmp/a5idc-first-index.html <<'EOF'
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>网站首次部署验证</title>
</head>
<body>
<h1>网站已启动</h1>
<p>部署标记:first-deploy-v1</p>
</body>
</html>
EOF
sudo install -m 0644 /tmp/a5idc-first-index.html "$SITE_ROOT/index.html"
此操作会覆盖首页,因此前面的备份不可省略。0644适用于不包含秘密的静态页面;不要把数据库密码、私钥或环境配置放入网站公开目录,也不要用chmod -R 777解决权限问题。
在服务器内部验证虚拟主机
域名尚未解析时,也可以通过指定请求域名测试本机Web服务:
curl --noproxy '*' -i \
--resolve www.example.com:80:127.0.0.1 \
http://www.example.com/
这条命令适用于80端口已映射到本机回环地址可访问范围的情况。它既绕开公共DNS,又保留正确的请求域名,比直接访问IP更适合验证虚拟主机。
以下为预期结果示例,不是实际执行记录:
HTTP/1.1 200 OK
Content-Type: text/html
...
<p>部署标记:first-deploy-v1</p>
返回200但没有部署标记,通常说明命中了默认站点、根目录填错或存在旧缓存。静态文件修改通常不需要重启整个容器;修改Web配置时,则应先做配置检查,再通过面板执行重载。
四、让域名与HTTPS真正生效
添加DNS记录并从外部测试
在域名DNS管理处添加A记录:
| 主机记录 | 类型 | 记录值 |
|---|---|---|
www | A | 香港服务器实际公网IPv4 |
首次排障可先使用直接解析到服务器的方式,暂不叠加CDN等中间层。若添加AAAA记录,必须确认服务器IPv6、监听地址和入站规则都已配置,否则部分访问者会因优先使用IPv6而失败。
检查解析:
dig +short A www.example.com
dig +short AAAA www.example.com
A记录应返回目标IPv4;未配置IPv6时,AAAA没有结果是正常现象。DNS修改可能受到旧记录缓存影响,不应仅凭一次查询就判断所有访问地区已经更新。
从个人电脑或另一台服务器执行:
curl -i http://www.example.com/
尚在等待DNS更新时,可先测试公网服务器与网站绑定。下列203.0.113.10是文档示例IP,必须替换:
curl --noproxy '*' -i \
--resolve www.example.com:80:203.0.113.10 \
http://www.example.com/
本机访问成功不代表网站已经上线。只有外部请求能够到达公网端口,并命中正确域名和页面,才能证明公网访问链路基本成立。

申请并绑定网站证书
在1Panel证书管理中申请www.example.com的证书,再到该网站的HTTPS设置中绑定证书。首次部署可以采用HTTP验证,但需同时满足:
- 域名解析指向这台服务器。
- 公网80端口能够访问。
- 验证请求没有被访问控制、错误跳转或中间服务拦截。
- 系统时间正确。
通配符域名通常需要DNS验证;涉及DNS接口凭据时,应使用最小权限凭据,不要把凭据写入页面或日志。
证书签发并绑定后,再启用HTTP跳转HTTPS。不要在HTTPS尚未可用时提前强制跳转,否则容易把所有访问引向错误入口。
从外部验证:
curl -I https://www.example.com/
curl -I http://www.example.com/
curl -fsS https://www.example.com/ | grep -F 'first-deploy-v1'
HTTPS应能够完成正常证书校验,页面中能找到部署标记;HTTP应跳转到正确的HTTPS地址,常见返回状态为301或308。不要使用curl -k作为证书验收方法,它会跳过证书校验。
最后确认自动续期已启用。采用HTTP验证续期时,通常仍需保持80端口及验证路径可达;采用DNS验证时,则要确认相关凭据持续有效。
五、失败时按“外部到内部”定位
排障先查只读状态,再改配置。不要在原因不明时同时修改DNS、防火墙、容器映射和网站根目录,否则即使恢复访问,也难以确认是哪一步解决了问题。
| 现象 | 先检查什么 | 不同结果意味着什么 |
|---|---|---|
| 域名访问超时 | DNS结果、安全组、80/443规则 | 解析正确仍超时,重点查网络入口 |
| 连接被拒绝 | 主机监听、容器状态和端口映射 | 通常没有服务监听,或被主动拒绝 |
| 出现默认欢迎页 | 请求域名、网站绑定、配置是否生效 | 已到达Web服务,但未命中目标站点 |
| 返回403 | 首页是否存在、读取权限、访问限制 | 不应直接放宽整个目录权限 |
| 返回404 | 根目录、URL路径和文件名大小写 | 资源不存在或映射位置错误 |
| HTTPS证书错误 | 域名匹配、证书绑定、有效期与证书链 | 不能用忽略证书错误代替修复 |
| 静态网站返回502 | 网站类型、反向代理配置 | 可能误选了动态或反向代理站点 |
面板打不开,但SSH正常
先检查安装输出中的端口与安全入口路径,再核对监听和服务状态:
sudo ss -lntp
systemctl list-units --type=service --all | grep -i 1panel
面板能登录,不代表网站80、443端口开放;网站能访问,也不代表管理端口应该向所有来源开放。两者应分别验收。
容器没有启动或反复重启
确认容器名称,再读取日志:
sudo docker ps -a --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'
把实际名称填入下一条命令:
WEB_CONTAINER="实际OpenResty容器名称"
sudo docker logs --tail 100 "$WEB_CONTAINER"
若日志指出端口占用,回到ss -lntp查对应服务;若提示配置错误,使用面板提供的配置检查功能定位。配置变更前先导出原文件,恢复原配置通常比反复重装应用更低风险。
镜像拉取失败则检查出站DNS、网络和磁盘空间。对仍承载网站的容器,不要先删除再排障,删除操作可能同时影响配置、挂载和业务可用性。
本机正常,公网访问失败
依次检查:
- 域名是否指向正确公网IP。
- 服务器平台安全组是否允许目标端口。
- 系统防火墙是否拦截。
- 容器是否发布了对应端口,绑定地址是否正确。
- 是否存在错误的AAAA记录。
先用外部curl --resolve排除公共DNS影响,再测试正常域名解析。如果前者成功、后者失败,问题更可能在DNS、IPv6或中间访问层,而不是网站文件。
六、上线验收与回滚检查项
交付前逐项验收
- [ ] 系统版本、架构、磁盘空间和时间符合部署要求。
- [ ] Docker、1Panel及OpenResty状态正常,没有持续重启。
- [ ] 网站根目录与容器挂载关系正确,首页包含预期部署标记。
- [ ] 公网A记录正确;存在AAAA记录时,IPv6链路也已验证。
- [ ] 从服务器外部访问HTTPS成功,证书校验无异常。
- [ ] HTTP能够跳转到正确的HTTPS地址。
- [ ] 面板管理入口仅对授权来源开放,管理员密码已妥善保存。
- [ ] 证书续期、网站备份和日志容量检查已纳入维护。
- [ ] 没有将数据库、容器管理接口或其他非必要端口暴露到公网。
页面可以访问只是验收的一部分。面板访问范围、证书续期和备份可恢复性,同样属于首次部署的交付结果。
页面发布失败时恢复原首页
本教程只替换了index.html,因此优先做文件级回滚,不必恢复整台服务器。将以下两个路径替换成实际值;此操作会覆盖当前首页,执行前确认它仍是本次发布的文件。
SITE_ROOT="/opt/1panel/www/sites/www.example.com/index"
BACKUP_DIR="/root/deploy-backups/www.example.com-实际备份时间"
if sudo test -f "$BACKUP_DIR/index.html"; then
sudo cp -a "$BACKUP_DIR/index.html" "$SITE_ROOT/index.html"
elif sudo test -f "$BACKUP_DIR/index-was-absent"; then
sudo mv "$SITE_ROOT/index.html" "$BACKUP_DIR/index.html.failed"
else
echo "找不到有效备份标记,停止回滚"
fi
原来有首页时恢复旧文件;原来没有首页时,将本次发布文件移出网站目录保留,而不是直接删除。回滚后重新执行本机与外部访问验证,必要时清理浏览器缓存。
配置或系统变更失败时按范围回退
- DNS变更失败:恢复原记录,并考虑缓存未过期造成的暂时差异。
- 防火墙规则错误:撤销本次新增规则,保留原有SSH访问;失去连接时使用控制台救援。
- Web配置错误:恢复导出的原配置,检查通过后再重载。
- 新建站点不再使用:先备份页面、配置和证书,再解除绑定;确认不影响其他网站后才能删除。
- 系统安装需要整体撤销:仅在确认快照之后没有新增业务数据时恢复安装前快照。已有新数据时先导出,避免整机回退造成丢失。
完成回滚后,继续检查SSH、面板、网站和证书状态,而不只确认某一条命令执行成功。首次部署的可靠终点,是网站能够从公网正确访问,管理入口受到限制,且下一次改动有明确的备份与恢复路径。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3315.html


