# 一个产品助理的第一次服务器部署：Flask + Gunicorn + Nginx 踩坑记

## 写在前面

我不是开发，本职是产品助理。前一阵需要做一个内部小工具：把几个系统里的数据拉出来，用一个简单的网页展示，方便同事查。

需求不复杂，但对我是个坎——我上一次碰命令行，还是大学装 Python 环境的时候，装完就删了。

最后这个工具跑起来了，现在还在线上。整个过程我基本是靠着 AI 边问边做，踩了不少坑，记下来给同样不是开发、但要自己动手的人参考。

技术栈很朴素：**Flask + Gunicorn + Nginx + systemd**，服务器是阿里云的一台轻量应用服务器（2 核 2G）。

## 一、为什么选 Flask

三个原因：

1. 文件少。一个 `app.py` 就能跑起来，不用先理解一整套框架的设计哲学
2. 报错看得懂。Flask 的报错页面直接把出错的行和原因写出来，不像有些框架要翻半天日志
3. 改一行就能看到效果，反馈快

如果要做的工具只有几个页面、没有复杂权限体系，Flask 完全够用。别一上来就上 Spring Boot，那是给自己找麻烦。

## 二、本地先跑通，再谈上线

这一步很多人会跳过，直接买服务器。**别跳。**

本地跑通的意思是：

```bash
python -m venv venv
source venv/bin/activate        # Windows 用 venv\Scripts\activate
pip install -r requirements.txt
python app.py
```

浏览器打开 `http://127.0.0.1:5000`，能看到页面，才算第一步完成。

顺便做两件事：

- **把依赖锁进 `requirements.txt`**：`pip freeze > requirements.txt`。不做这一步，线上装依赖时版本会飘，本地能跑线上报错
- **把配置抽到 `.env`**：密钥、数据库地址这类东西不要写死在代码里

```python
# app.py
import os
from dotenv import load_dotenv

load_dotenv()

API_KEY = os.getenv("API_KEY")
```

这一步现在多花五分钟，后面能省掉一次"密钥被提交到 Git 仓库"的事故。

## 三、服务器：先把门锁好

买完服务器，第一件事不是装环境，是**把安全设置做掉**。很多人（包括我）默认觉得"反正是内部工具，没人看"，但扫描器是不挑对象的，挂上去几小时就能收到爆破日志。

我做的最小配置：

1. **禁用密码登录，只用 SSH 密钥**
2. **改掉默认的 22 端口**（不算安全措施，但能过滤掉大部分无差别扫描）
3. **云控制台的防火墙只放 22、80、443**，其他端口一律不开
4. **建一个普通用户跑服务，不用 root**

关于第 3 点，后面会单独说，因为它是我踩得最久的一个坑。

## 四、把代码传上去

两种方式，看习惯：

```bash
# 方式一：Git（推荐，方便回滚）
git clone <你的仓库地址>

# 方式二：直接传
scp -r ./myapp user@你的服务器IP:/home/user/
```

如果用 Git，**`.gitignore` 一定要先写好**：

```
venv/
.env
__pycache__/
*.pyc
```

`.env` 只要被提交过一次，就算后面删掉，历史记录里也还在。真发生了，唯一的正解是**去把所有密钥轮换一遍**，别指望删文件能补救。

## 五、让它一直跑着：Gunicorn + systemd

这是新手最常犯的错：SSH 里敲一句 `python app.py`，看着跑起来了，然后关掉终端——服务没了。

Flask 自带的开发服务器也不该用在线上，它是单线程的，几个人同时访问就卡。

正确的做法是两层：

**第一层，用 Gunicorn 跑应用：**

```bash
pip install gunicorn
gunicorn -w 2 -b 127.0.0.1:8000 app:app
```

**第二层，用 systemd 托管它：**

新建 `/etc/systemd/system/myapp.service`：

```ini
[Unit]
Description=My Flask App
After=network.target

[Service]
User=myuser
WorkingDirectory=/home/myuser/myapp
Environment="PATH=/home/myuser/myapp/venv/bin"
ExecStart=/home/myuser/myapp/venv/bin/gunicorn -w 2 -b 127.0.0.1:8000 app:app
Restart=always

[Install]
WantedBy=multi-user.target
```

然后：

```bash
sudo systemctl daemon-reload
sudo systemctl enable myapp
sudo systemctl start myapp
sudo systemctl status myapp
```

`Restart=always` 这一行是关键——服务器重启、进程崩了，它都会自己拉起来。

看日志用：

```bash
journalctl -u myapp -f
```

这个命令后来救了我好几次。**出问题第一件事就是看日志，别猜。**

## 六、Nginx 挡在前面

Gunicorn 监听的是 `127.0.0.1:8000`，外网访问不到。前面加一层 Nginx 做反向代理：

```nginx
server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
```

好处有三个：静态文件处理更快、能挂 HTTPS、以后要加子域名或限流都方便。

要 HTTPS 的话，装个 certbot 一条命令就能签证书，免费，自动续期。

## 七、我踩的五个坑

**坑 1：`.env` 没传上去，线上直接 500**

本地跑得好好的，线上一起就报错。原因是我把 `.env` 加进了 `.gitignore`，`git clone` 下来自然没有这个文件。

解决办法是在服务器上手动建一份，或者用 `scp` 单独传。**这次是配置缺失，下次可能是密钥泄露——同一个动作的两面。**

**坑 2：本地 curl 通，外面打不开**

这个坑卡了我一下午。

我在服务器上 `curl http://127.0.0.1:8000` 是有返回的，但用浏览器从外面访问就是超时。

原因：**云服务商的防火墙是独立于服务器自身防火墙的**。我在服务器上开了端口，但云控制台的安全组没放行，等于门口挂了个牌子但大门锁着。

反过来也成立：阿里云、腾讯云的"防火墙/安全组"和服务器里的 `ufw`/`iptables` 是两套东西，两边都要放行。

**坑 3：SSH 断开服务就停**

前面说过了，`python app.py` 是前台进程。除了用 systemd，也可以用 `tmux` 或 `screen` 挂着，但那是临时方案，正式环境还是 systemd 靠谱。

**坑 4：用 root 跑服务**

图省事直接 root 起来，出问题时影响面是整台机器。建个普通用户，`chown` 一下目录，多花两分钟。

**坑 5：日志时间全是 UTC**

服务器默认时区是 UTC，日志里显示的时间比北京时间差 8 小时，排查问题时对不上。

```bash
sudo timedatectl set-timezone Asia/Shanghai
```

改完记得重启服务。

## 八、用 AI 协作的几个体会

整个过程我基本是边问边做，有几点感受：

**1. 让它解释"为什么"，比让它直接给命令有用**

一开始我的用法是"给我一条命令"，拿到了就复制粘贴。结果一出错就卡死，因为我不知道这条命令在干什么，也没法判断哪里错了。

后来改成"这条命令在做什么，每一步的作用是什么"，虽然慢一点，但后面出问题时自己能定位。

**2. 出问题先给它日志，别描述现象**

"打不开"这种描述，能对应十几种原因。把 `journalctl` 的输出、浏览器报错、`curl -v` 的结果贴过去，定位速度差好几倍。

**3. 密钥别进对话**

哪怕是和 AI 聊，密钥、密码也不该出现在对话记录里。用占位符（`YOUR_KEY_HERE`）替代，自己替换。

**4. 让它帮你写"检查清单"，而不是只写代码**

部署这种事，漏一步就卡住。让它先列出完整步骤清单，你照着一步步打勾，比想到哪做到哪靠谱得多。

## 最后

这件事做完，我最大的收获不是"学会了部署"，而是**搞清楚了从浏览器输入网址到页面显示出来，中间经过了哪几层**。

以前这是个黑箱：点一下，页面出来了，不知道为什么。现在知道请求先到 Nginx，被转发给 Gunicorn，Gunicorn 调 Flask 的代码，代码里再去请求外部接口，结果一层层返回。

这个认知比会敲几条命令值钱。下次遇到"网站打不开"，至少知道该从哪一层开始查。

如果你也是非开发岗、手上有个小工具想做出来，建议别一开始就想架构。**先让它跑起来，再让它跑得稳，最后才谈优化。** 顺序反了，很容易在第一步就放弃。


我不是开发，本职是产品助理。前一阵需要做一个内部小工具：把几个系统里的数据拉出来，用一个简单的网页展示，方便同事查。

一个产品助理的第一次服务器部署：Flask + Gunicorn + Nginx 踩坑记

前端

人工智能

Flask+Gunicorn+Nginx服务器部署全指南，针对非开发人员的实战踩坑记录。文章详细讲解从本地环境搭建、SSH安全配置、代码部署到systemd进程管理的完整流程，并总结云防火墙配置、环境变量缺失、SSH断开服务终止等5个常见问题的解决方案。适合产品经理、运营等非技术岗人员快速掌握Linux服务器部署技能，实现内部工具的自主搭建与维护。

轻量应用服务器

文件处理

代码解释

数据库

服务器

防火墙

Windows

Python

Nginx

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Flask+Gunicorn+Nginx服务器部署全指南，针对非开发人员的实战踩坑记录。文章详细讲解从本地环境搭建、SSH安全配置、代码部署到systemd进程管理的完整流程，并总结云防火墙配置、环境变量缺失、SSH断开服务终止等5个常见问题的解决方案。适合产品经理、运营等非技术岗人员快速掌握Linux服务器部署技能，...

一个产品助理的第一次服务器部署：Flask + Gunicorn + Nginx 踩坑记-腾讯云开发者社区-腾讯云

一个产品助理的第一次服务器部署：Flask + Gunicorn + Nginx 踩坑记

一个产品助理的第一次服务器部署：Flask + Gunicorn + Nginx 踩坑记

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐