作为一名学生开发者，近期完成了校园失物招领网站的开发与部署，从本地调试正常到云服务器成功上线，踩了不少新手常见的坑，也积累了一套可直接复用的部署经验。本文全程不涉及服务器安全敏感信息，仅分享部署流程、核心踩坑点及解决方案，适合和我一样的新手参考，帮助大家少走弯路，高效完成网站部署。

网站技术栈：Flask（后端）+ Docker（容器化部署）+ Nginx（反向代理），部署环境为CentOS 7，最终实现“公网IP/域名直接访问网站”，无需手动添加端口号，全程实操可复现。

一、部署前准备（本地+服务器）

部署前的准备工作直接决定后续流程是否顺畅，新手最容易忽略“本地与服务器环境统一”，导致部署时出现“本地正常、服务器报错”的问题，重点做好以下2点：

1. 本地代码规范（避免部署踩坑的核心）

本地开发时的代码不规范，是部署后出现各种问题的主要原因，提前规范代码，能节省大量排查时间，重点规范3个方面：

（1）Flask监听配置统一

本地开发时，很多新手会使用Flask默认的监听配置（app.run()），默认监听127.0.0.1:5000，这会导致部署到服务器容器后，外部无法访问容器内的应用。

✅ 规范配置（本地代码修改）：

if __name__ == '__main__': # host='0.0.0.0'：允许容器外部访问，适配服务器环境 # port=8000：统一端口，与服务器容器映射端口保持一致 # debug=True：仅本地开发用，部署到服务器后需改为False app.run(host='0.0.0.0', port=8000, debug=True)

（2）Docker Compose配置规范

容器化部署能避免环境依赖问题，但本地docker-compose.yml配置不规范，会导致服务器容器启动失败或无法访问。

✅ 规范配置（本地docker-compose.yml）：

version: '3.8' services: campus_app: build: . # 本地与服务器构建镜像规则一致 ports: - "8000:8000" # 端口映射，本地与服务器保持统一 restart: always # 服务器容器意外退出时自动重启，保证网站稳定 command: python app.py # 明确启动命令，避免服务器容器无入口

（3）路径与日志配置（方便后续排查问题）

本地开发时使用绝对路径（如Windows路径C:/project/static），部署到Linux服务器后会失效；未配置日志，服务器报错后无法定位问题。

✅ 规范配置（本地代码修改）：

import os import logging from logging.handlers import RotatingFileHandler # 1. 相对路径配置（本地与服务器通用） BASE_DIR = os.path.dirname(os.path.abspath(__file__)) STATIC_DIR = os.path.join(BASE_DIR, 'static') # 静态资源路径 UPLOAD_DIR = os.path.join(STATIC_DIR, 'uploads') # 上传文件路径 # 确保路径存在，避免服务器报错 if not os.path.exists(UPLOAD_DIR): os.makedirs(UPLOAD_DIR, mode=0o755) # Linux权限兼容 # 2. 日志配置（本地与服务器统一，方便排查问题） LOG_DIR = os.path.join(BASE_DIR, 'logs') if not os.path.exists(LOG_DIR): os.makedirs(LOG_DIR) # 日志格式配置 handler = RotatingFileHandler( os.path.join(LOG_DIR, 'app.log'), maxBytes=10*1024*1024, # 单日志文件10MB backupCount=5 # 保留5个备份日志 ) handler.setFormatter(logging.Formatter('%(asctime)s - %(levelname)s - %(filename)s:%(lineno)d - %(message)s')) app.logger.addHandler(handler) app.logger.setLevel(logging.INFO)

2. 服务器环境准备

提前在云服务器上安装必要的软件，避免部署时临时安装出错，需安装的软件：Docker、Docker Compose、Nginx，安装流程可参考官方文档，新手建议使用一键安装脚本，简化操作。

重点提醒：安装完成后，启动Docker和Nginx服务，确保服务正常运行（可通过systemctl status 服务名 查看状态）。

二、核心部署流程（step by step，新手可直接照搬）

部署流程按“容器部署→Nginx配置→端口开放→域名解析”的顺序进行，每一步都有明确的操作和验证方法，避免漏步骤导致部署失败。

Step 1：部署Flask应用（Docker容器化）

1. 将本地规范后的代码，通过Xshell、FileZilla等工具上传到服务器的指定目录（如/home/project）；

2. 进入代码目录，执行容器启动命令：

# 构建镜像并启动容器（后台运行） docker compose up -d

3. 验证容器是否正常运行，这一步是关键，很多新手会跳过，导致后续Nginx反向代理报错：

# 查看容器状态，确保状态为Up docker compose ps # 若容器未运行，查看报错日志，定位问题 docker compose logs

✅ 验证成功：容器状态为Up，且在服务器本地访问127.0.0.1:8000能看到网站页面。

Step 2：配置Nginx反向代理（实现无端口访问）

Flask应用默认暴露8000端口，需配置Nginx监听80端口（HTTP默认端口），将请求转发到8000端口，实现“输入公网IP/域名直接访问”，这是新手最容易踩坑的环节。

1. 编辑Nginx主配置文件

# 打开Nginx配置文件 vi /etc/nginx/nginx.conf

2. 新增80端口反向代理规则

找到http块，在include /etc/nginx/conf.d/*.conf; 之后、原有server块之前，添加以下配置（严格注意语法格式）：

server { listen 80; # 监听HTTP默认端口80 listen [::]:80; # 兼容IPv6 server_name _; # 匹配所有公网IP和域名 # 所有请求转发到Flask容器的8000端口 location / { proxy_pass http://127.0.0.1:8000; # 指向容器内应用 proxy_set_header Host $host; # 传递域名/IP到Flask proxy_set_header X-Real-IP $remote_addr; # 传递真实客户端IP } }

3. 关键语法提醒（新手必看）

Nginx配置对空格、分号、大括号极其敏感，这是我部署时卡了很久的坑，重点注意：

- location 和 / 之间必须有1个空格，/ 和 { 之间也必须有1个空格（不能写成location/{）；

- 每个指令结尾必须加分号（如listen 80; 不能少分号）；

- location块必须在server块内，server块必须在http块内，大括号必须成对出现。

4. 验证Nginx配置并重启

# 检查配置语法是否正确（必须执行，避免语法错误导致Nginx启动失败） nginx -t # 语法正确后，重启Nginx使配置生效 systemctl restart nginx

✅ 验证成功：执行nginx -t 显示“syntax is ok”和“test is successful”，重启后Nginx状态为active (running)。

Step 3：开放80端口（必做，否则无法公网访问）

服务器默认会拦截外部访问，需开放80端口，分为两步：服务器本地防火墙放行 + 云服务器安全组放行（新手最容易漏安全组配置，导致无法访问）。

# 1. 服务器本地防火墙放行80端口（永久生效） firewall-cmd --add-port=80/tcp --permanent firewall-cmd --reload # 2. 云服务器安全组放行80端口（登录云控制台操作） # 入站规则：端口80，协议TCP，授权对象允许所有IP访问（0.0.0.0/0）

✅ 验证成功：执行netstat -tulpn | grep ":80"，能看到Nginx监听80端口。

Step 4：域名解析（可选，实现域名访问）

若有自己的域名，可配置域名解析，实现“输入域名直接访问网站”，步骤如下：

1. 登录域名服务商后台（如阿里云、腾讯云），找到域名解析设置；

2. 添加A记录，配置如下：

- 记录类型：A（将域名指向IPv4地址）；

- 主机记录：@（根域名）和www（www前缀域名）；

- 记录值：服务器公网IP；

- TTL：600（10分钟，生效更快）。

3. 等待解析生效（10-30分钟），验证方法：ping 域名，返回服务器公网IP即生效。

三、部署时的核心踩坑复盘（新手重点避坑）

结合我部署时的实际经历，整理了6个最容易踩的坑，每个坑都有明确的原因和解决方案，避开这些坑，部署效率能提升80%。

坑1：Flask容器启动后，服务器本地无法访问127.0.0.1:8000

❌ 原因：本地Flask监听配置未设置host='0.0.0.0'，容器内应用仅监听127.0.0.1，外部无法访问；

✅ 解决方案：修改本地Flask启动代码，设置host='0.0.0.0'，重新上传代码并重启容器。

坑2：Nginx配置后，执行nginx -t 报unknown directive "location/"

❌ 原因：语法错误，location和/之间、/和{之间没有留空格，写成了location/{；

✅ 解决方案：修正为location / {，确保两个空格都存在，所有指令结尾加分号。

坑3：查询80端口状态时，误判端口被占用

❌ 原因：使用grep 80查询，会匹配到8000、8080、8082等含80的端口，且终端缓存混淆结果；

✅ 解决方案：使用clear && netstat -tulpn | grep ":80"，先清空终端，再精准匹配80端口。

坑4：配置Nginx后，访问公网IP提示拒绝连接

❌ 原因：未开放80端口，尤其是云服务器安全组未添加80端口入站规则（新手最容易漏）；

✅ 解决方案：重新配置服务器防火墙和云安全组，确保80端口放行，等待1-2分钟生效。

坑5：访问网站报502 Bad Gateway

❌ 原因：Flask容器未正常运行，Nginx无法转发请求；

✅ 解决方案：执行docker compose ps 查看容器状态，若未运行，执行docker compose up -d 重启容器，查看日志定位启动失败原因。

坑6：域名解析后，无法访问网站

❌ 原因：解析未生效（需等待10-30分钟），或国内服务器域名未做ICP备案（被运营商拦截）；

✅ 解决方案：等待解析生效，国内服务器需提前完成ICP备案，境外服务器无需备案。

四、部署总结与后续优化建议

1. 部署总结

新手部署网站，核心是“本地代码规范+服务器环境统一+步骤不遗漏”，重点关注3个核心环节：

- 本地代码：统一监听端口、规范容器配置、使用相对路径和日志；

- Nginx配置：严格遵守语法规则，确保反向代理规则正确；

- 端口与解析：开放80端口（防火墙+安全组），域名解析耐心等待生效。

只要按步骤操作，避开上述坑，就能顺利完成网站部署，实现公网访问。

2. 后续优化建议

1. 安全优化：对用户输入做HTML转义（防XSS漏洞）、添加输入验证（防非法数据），本地测试时模拟非法输入，确保公网环境安全；

2. 稳定性优化：配置Nginx静态资源缓存，减少Flask服务器压力；设置容器自动重启，避免意外退出；

3. 维护优化：定期查看服务器日志，排查异常问题；备份数据库和代码，防止数据丢失。

五、最后寄语

作为新手，部署网站踩坑是正常的，每一个坑都是一次经验积累。本文总结的所有经验，都是我实际部署中一步步试错、排查得出的，希望能帮助和我一样的新手，少走弯路，顺利完成自己的网站部署。