在香港服务器上安装1Panel面板,如何完成网站首次部署?

发布人:A5数据发布时间:2026-10-12 10:01阅读量:223

第一次部署不必同时搭建数据库、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_64uname -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。首次部署使用面板提供的常规配置即可:

  1. 确认HTTP端口为80、HTTPS端口为443。
  2. 不安装当前网站不需要的数据库或语言运行环境。
  3. 等待应用状态变为运行中。
  4. 查看安装日志,确认没有端口冲突或镜像拉取失败。

容器运行状态可以在终端复核:

sudo docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'

应看到OpenResty对应容器处于运行状态,并有80、443端口映射。若只显示容器内部端口,没有主机端口映射,需要检查应用配置;若绑定在127.0.0.1上,也不能直接从公网访问。

注意:Docker发布的容器端口与UFW之间存在规则交互,不能仅凭UFW显示“拒绝”就认定容器端口没有暴露。公网入口应优先通过服务器平台安全组约束,再从外部实际验证。

三、先发布页面,再接入域名 / 从应用商店安装OpenResty配图

创建静态网站

在“网站”功能中创建网站,选择静态网站类型,填写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记录:

主机记录类型记录值
wwwA香港服务器实际公网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/

本机访问成功不代表网站已经上线。只有外部请求能够到达公网端口,并命中正确域名和页面,才能证明公网访问链路基本成立。

四、让域名与HTTPS真正生效 / 添加DNS记录并从外部测试配图

申请并绑定网站证书

在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、网络和磁盘空间。对仍承载网站的容器,不要先删除再排障,删除操作可能同时影响配置、挂载和业务可用性。

本机正常,公网访问失败

依次检查:

  1. 域名是否指向正确公网IP。
  2. 服务器平台安全组是否允许目标端口。
  3. 系统防火墙是否拦截。
  4. 容器是否发布了对应端口,绑定地址是否正确。
  5. 是否存在错误的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

相关推荐