Fabric 在 Flask 部署中易现 ConnectionRefusedError，主因是云服务器默认禁用密码登录、仅支持密钥认证，而 Fabric 2.x 默认尝试密码登录；需配置 PubkeyAuthentication、添加公钥、显式指定 key_filename，并创建专用部署用户。
为什么 Fabric 在 Flask 部署中容易卡在 ConnectionRefusedError
不是代码写错了，而是默认用 SSH 密码登录时，云服务器（尤其阿里云、腾讯云新实例）通常禁用了密码认证，只允许密钥登录。Fabric 2.x 默认尝试密码登录，没配密钥就会连不上。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 确认云服务器的
/etc/ssh/sshd_config中PubkeyAuthentication yes已开启，并已将本地公钥（如~/.ssh/id_rsa.pub）追加到服务器的~/.ssh/authorized_keys - Fabric 脚本里必须显式指定密钥路径：
connect_kwargs={"key_filename": "/path/to/id_rsa"} - 别用 root 用户直连——创建部署专用用户（如
deploy），并确保该用户对项目目录有读写权限、能执行systemctl --user或supervisorctl
fab deploy 执行后 Flask 进程没起来，journalctl -u myapp 显示 ModuleNotFoundError: No module named 'flask'
本地开发环境装了 Flask，但服务器上压根没装，或者装在了错的 Python 环境里。Fabric 默认不自动同步虚拟环境，它只传文件、不装依赖。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 部署脚本里必须包含 pip 安装步骤，例如：
run("pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ -r /var/www/myapp/requirements.txt") - 务必用绝对路径调用 pip，避免系统多个 Python 版本导致装错地方，比如用
/opt/venv/bin/pip而不是裸写pip - 如果用 systemd 管理进程，检查
ExecStart=指向的 Python 解释器是否和安装依赖时用的是同一个（常见坑：用/usr/bin/python3启动，却在/opt/venv里装包）
静态文件 404、url_for('static', filename='app.js') 生成的路径总是错
Flask 开发时靠调试服务器自动服务 static 目录，但生产部署后，Nginx 应该接管静态文件，Flask 本身不该处理 /static/ 请求。如果 Nginx 没配好，请求就落到 Flask，而 Flask 在非调试模式下默认不提供静态文件服务。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- Nginx 配置里必须明确声明 static 路径映射：
location /static { alias /var/www/myapp/static/; }（注意末尾斜杠和 alias 路径一致性） - Flask 的
static_folder和static_url_path要和 Nginx 的alias对齐；例如 Flask 设为static_url_path='/static'，Nginx 就不能写成location /assets { ... } - 确保服务器上
/var/www/myapp/static/目录真实存在且有文件，Fabric 的put()默认不会覆盖整个目录，建议先run("rm -rf /var/www/myapp/static")再上传
每次改代码都要手动 git pull + pip install -r + sudo systemctl restart？
可以自动化，但别把所有命令堆在 Fabric 的一个 run() 里。Fabric 的连接是短生命周期的，命令间不共享 shell 环境，cd 切换目录、source 激活 venv 等操作在下一条 run() 中全部失效。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用
run("cd /var/www/myapp && source /opt/venv/bin/activate && pip install -r requirements.txt")把相关命令串在一行 shell 里执行 - 用
sudo权限重启服务时，确保目标用户已被加入sudoers且免密（如deploy ALL=(ALL) NOPASSWD: /bin/systemctl restart myapp） - 加个简单的版本标记：部署前
run("git rev-parse --short HEAD > /var/www/myapp/VERSION")，方便出问题时快速核对线上跑的是哪次提交
真正麻烦的从来不是写 Fabric 脚本，而是服务器上 Python 环境、用户权限、Nginx 配置、systemd 单元文件这四者之间的边界是否清晰——少一个对齐，发布就静默失败。
