如何在Linux服务器上部署Nginx UI并确认管理界面可以访问?

发布人:A5数据发布时间:2026-10-26 17:28阅读量:108

在Linux服务器上首次部署Nginx UI,可以先采用Docker Compose运行一个独立实例:让管理界面只监听服务器本机端口,再通过SSH端口转发从自己的电脑访问。这样无需立即开放公网管理端口,也不会在首次试用时改动服务器现有的Nginx配置。

下面的步骤适用于已安装Docker Engine和Docker Compose插件、能够通过SSH登录的Linux服务器。示例中的Nginx UI管理的是容器内的Nginx,不是宿主机上可能已经运行的Nginx。首次验收以“容器正常运行、管理页面可打开、能够完成管理员初始化”为目标;若后续需要管理宿主机Nginx,应另行评估配置挂载、权限与备份,不能直接把本示例当作宿主机配置管理方案。

准备条件:确认环境与端口

先在服务器上检查Docker、Compose和SSH登录环境。以下命令在服务器终端执行:

sudo docker version
sudo docker compose version
sudo docker info

预期结果是命令均能正常返回,且docker info能够连接Docker服务端。如果提示docker: 'compose' is not a docker command,说明当前环境没有可用的Compose插件;应先按该发行版及Docker安装方式补齐插件,不要把旧版docker-compose命令直接混入下文。

本例把容器的HTTP端口映射到服务器的127.0.0.1:18080。创建文件前,确认该端口未被占用,并查看目标目录是否已有部署文件:

sudo ss -lntp
sudo ls -ld /opt/nginx-ui-demo

在ss输出中查找:18080:如果已有监听,换一个未使用的本机端口,并在后续Compose文件、SSH转发命令中同步修改。若/opt/nginx-ui-demo已存放其他项目,不要覆盖其中的compose.yaml,应改用新的目录。ls提示目录不存在,则符合本例的首次部署预期。

还需要确认服务器能拉取容器镜像,自己的电脑能通过SSH连接服务器。本文不要求开放18080的公网入站规则;请保留现有SSH连接,完成界面验收后再决定是否采用正式的访问入口。

承载Nginx UI这类容器化管理界面及相关网站、业务后台,A5数据提供中国香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器租用,覆盖不同CPU、内存、SSD或NVMe存储与网络线路方案,可为Linux服务器部署和多地区业务提供硬件与网络资源基础。

创建Compose部署文件

在确认目标目录不会覆盖已有文件后,创建目录与compose.yaml:

sudo mkdir -p /opt/nginx-ui-demo

sudo tee /opt/nginx-ui-demo/compose.yaml > /dev/null <<'YAML'
services:
  nginx-ui:
    image: uozi/nginx-ui:latest
    container_name: nginx-ui-demo
    restart: unless-stopped
    ports:
      - "127.0.0.1:18080:80"
    volumes:
      - nginx_config:/etc/nginx
      - nginx_ui_/etc/nginx-ui
      - nginx_www:/var/www

volumes:
  nginx_config:
  nginx_ui_
  nginx_www:
YAML

这里使用Docker命名卷保存容器内的Nginx配置、Nginx UI数据和站点目录。它们与宿主机的/etc/nginx不是同一份数据:即使宿主机已经安装Nginx,本步骤也不会把宿主机配置挂进容器。端口映射左侧的127.0.0.1:18080限定服务器本机访问,右侧的80是容器内HTTP端口。

创建Compose部署文件配图

示例使用latest便于首次拉取,但它不是固定版本标识。正式长期使用前,建议记录本次镜像标识,并在验证兼容后改为明确的版本标签或镜像摘要,避免以后重新拉取时版本无意变化。

创建后先检查Compose解析结果,不急于启动:

cd /opt/nginx-ui-demo
sudo docker compose config

预期输出应包含nginx-ui服务、127.0.0.1:18080:80端口映射,以及三个命名卷。若命令报告YAML格式错误,先检查缩进和引号;不要在配置检查失败时继续执行启动命令。

拉取镜像并启动

配置解析通过后,拉取镜像并创建容器:

cd /opt/nginx-ui-demo
sudo docker compose pull
sudo docker compose up -d
sudo docker compose ps

pull成功表示镜像已取得;up -d成功后,ps中应能看到nginx-ui-demo处于运行状态,并显示预期的端口映射。拉取耗时取决于服务器到镜像仓库的网络状况,不宜把下载速度或耗时作为服务是否正常的判断依据。

可记录本次拉取的镜像ID,便于以后核对版本是否变化:

sudo docker image inspect uozi/nginx-ui:latest --format '{{.Id}}'

如果容器没有保持运行,先查看日志,不要反复执行up -d掩盖首次启动错误:

cd /opt/nginx-ui-demo
sudo docker compose logs --tail=100 nginx-ui

此时重点看是否有配置读取失败、目录权限错误或端口绑定失败。日志中出现启动信息只是一个信号,仍需做HTTP和浏览器验证。

验证管理界面能否访问

先在服务器本机检查HTTP响应

在服务器上执行:

curl -sS -o /dev/null -w 'HTTP %{http_code}\n' http://127.0.0.1:18080/

返回200,或因页面跳转返回301、302等状态,通常说明本机端口已有HTTP响应。但有HTTP响应不等于Nginx UI管理界面已经可用:仍需在浏览器确认页面身份并完成首次初始化。如果返回连接拒绝,优先回看docker compose ps和容器日志;如果返回的是普通Nginx欢迎页而非Nginx UI入口,也不能视为验收通过。

从自己的电脑建立SSH端口转发

在自己的电脑打开另一个终端,执行以下命令。将登录用户和服务器地址替换为实际SSH信息:

ssh -N -L 18080:127.0.0.1:18080 登录用户@服务器地址

保持该终端连接,在电脑浏览器中访问:

http://127.0.0.1:18080/

预期能看到Nginx UI的初始化或登录页面。首次部署时,按页面提示创建管理员账号,并设置独立的强密码;不要使用容易猜测的默认口令。初始化后退出并重新登录一次,确认账号可用。不同版本的首次页面和引导顺序可能不同,以实际界面为准,不要仅凭某个固定按钮名称判断安装是否失败。

SSH转发结束后,该电脑上的浏览器入口也会随之不可用;这不代表服务器容器停止运行。HTTP只经过服务器本机监听端口及SSH转发链路,不应把本例的HTTP地址直接发布为公网管理入口。

验证管理界面能否访问/从自己的电脑建立SSH端口转发配图

访问失败时按链路检查

排查时从连接入口逐层向内看,避免一开始就修改Nginx配置或放开防火墙。

  1. 电脑浏览器无法连接,但服务器本机curl有响应。确认SSH转发终端仍在运行;检查电脑本地18080端口是否已被占用。若本地端口冲突,可以只修改SSH命令左侧端口,例如使用-L 18081:127.0.0.1:18080,然后访问http://127.0.0.1:18081/,服务器Compose配置无需改变。
  2. 服务器本机curl提示连接拒绝。检查sudo docker compose ps中的容器状态和端口映射,再看sudo docker compose logs --tail=100 nginx-ui。若18080在启动前已被其他进程占用,修改Compose文件中的宿主机端口,并同步调整SSH命令;修改后用sudo docker compose config复核,再执行sudo docker compose up -d。
  3. 页面能打开,但不是Nginx UI或初始化无法完成。核对浏览器地址是否为本机转发端口,检查容器日志,并确认没有误连服务器上其他Web服务。若此前使用过同名命名卷,卷内可能保留旧数据;先查明其来源,不要直接删除卷来“重置密码”。
  4. 可以登录,但检查Nginx配置时报错。在本示例中,应先核对容器内Nginx,而非宿主机服务:
cd /opt/nginx-ui-demo
sudo docker compose exec nginx-ui nginx -t

预期看到语法检查成功的提示。若失败,先依据报错定位容器内配置文件;在修正前不要通过界面继续应用相关配置。

如果涉及端口修改、配置修正或权限调整,应先保留原文件副本,明确改动只作用于本例目录还是宿主机。尤其不要为了让首次页面打开而直接放开管理端口的公网访问,或把宿主机/etc/nginx临时挂入容器:前者扩大管理面暴露范围,后者可能让容器操作影响现有站点。

验收与回滚检查项

首次部署完成后,可按以下项目逐一核对:

  • sudo docker compose ps显示nginx-ui-demo持续运行,端口映射符合预期。
  • 服务器本机访问http://127.0.0.1:18080/得到HTTP响应;浏览器经SSH转发看到的是Nginx UI页面,而不是其他站点。
  • 管理员初始化完成,退出后能够重新登录;容器日志无持续重复的启动错误。
  • 如需在界面中管理本例的Nginx,容器内执行nginx -t通过;宿主机现有Nginx配置和监听端口未被本例改动。

如果决定撤回本次部署,在服务器上执行:

cd /opt/nginx-ui-demo
sudo docker compose down
sudo docker compose ps

down会停止并移除本例容器及其创建的网络,管理界面随即不可访问;默认不会删除三个命名卷,因此此前的初始化数据和容器内配置仍会保留。回滚后确认18080不再由本例监听,并检查宿主机原有站点是否仍按原方式工作。不要随手加上-v:该参数会删除本例的命名卷及其中数据;只有核对卷归属、完成所需备份,并确定不再需要恢复时才应考虑删除。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5918.html

相关推荐