宝塔面板不内置Rust运行时，需手动安装rustup与cargo并配置PATH；构建失败多因镜像源未设、权限不足或监听地址错误；反向代理502须确认服务绑定0.0.0.0、端口放行及systemd守护生效。
宝塔面板本身不提供 Rust 运行时，部署 Rust 应用必须手动安装 rustup + cargo，并自行管理进程与端口；反向代理只是把 Nginx 流量转给本地运行的 Rust 服务，和部署 Node/Python 本质一样——但 Cargo 环境配置稍有不同，容易因路径、权限或镜像失效导致构建失败。
rustup 安装后 cargo 命令找不到？PATH 没生效是主因
宝塔终端默认不加载用户 shell 配置（如 ~/.bashrc），即使执行了 source $HOME/.cargo/env，新开终端仍无效。
- 直接在宝塔终端里运行
source $HOME/.cargo/env后再试cargo --version，能查到说明临时生效 - 永久生效需把
export PATH="$HOME/.cargo/bin:$PATH"加进$HOME/.bashrc或/etc/profile（后者需 root 权限） - 宝塔「文件」界面编辑
/root/.bashrc时注意：如果用户不是root（比如你用普通用户登录宝塔），得改对应用户的~/.bashrc，路径是/www/wwwroot/your_user/.bashrc类似结构 - 验证方式：在宝塔终端执行
echo $PATH，确认输出里含/root/.cargo/bin或你的实际 bin 路径
构建失败提示 “Failed to download crate index”？Cargo 镜像配置要分版本
错误常出现在 cargo build 或 cargo run 第一次拉依赖时，尤其国内服务器。根本原因是 crates.io 默认走 AWS，而 config.toml 配置没生效或格式不对。
- 先确认
CARGO_HOME路径：echo $CARGO_HOME，若为空则默认是$HOME/.cargo - 创建或追加配置：
mkdir -p $HOME/.cargo && cat >> $HOME/.cargo/config.toml << 'EOF'，然后粘贴以下内容（适用于 cargo ≥ 1.68）：
[source.crates-io] replace-with = 'ustc' <p>[source.ustc] registry = "sparse+<a href="https://www.php.cn/link/9fcec5bdc065a562866029dd39b5b2ad">https://www.php.cn/link/9fcec5bdc065a562866029dd39b5b2ad</a>"</p><p>[registries.ustc] index = "sparse+<a href="https://www.php.cn/link/9fcec5bdc065a562866029dd39b5b2ad">https://www.php.cn/link/9fcec5bdc065a562866029dd39b5b2ad</a>"
- 若 cargo 版本 < 1.68（用
cargo --version查），把sparse+去掉，registry 改为"https://www.php.cn/link/9fcec5bdc065a562866029dd39b5b2ad" - 若仍报错
Couldn't resolve host name，加环境变量：CARGO_HTTP_MULTIPLEXING=false cargo build
反向代理指向 Rust 服务时 502？检查端口、监听地址与进程状态
Nginx 反向代理 502 多数不是配置问题，而是 Rust 服务根本没起来、没监听对地址、或被宝塔防火墙拦了。
- Rust 服务启动命令别写成
cargo run（只适合开发），应编译后运行二进制：cargo build --release && ./target/release/your_app - 确保代码里绑定的是
0.0.0.0:8080而非127.0.0.1:8080，否则 Nginx 从 localhost 转发会连不上（因为宝塔 Nginx 和你的 Rust 进程不在同一 network namespace） - 用
ss -tlnp | grep :8080确认端口是否真在监听，且进程 UID 匹配你的部署用户 - 宝塔「安全」页面要放行该端口（比如 8080），否则系统防火墙会 DROP
- Nginx 配置中
proxy_pass http://127.0.0.1:8080;是对的，但前提是上面三步都通
如何让 Rust 服务开机自启且不随终端关闭？别用 nohup，用 systemd
宝塔面板没有内置守护进程管理，靠 nohup 或 & 极易意外退出，systemd 是 Linux 标准解法，且宝塔不干扰它。
- 新建 service 文件：
sudo tee /etc/systemd/system/rust-app.service << 'EOF'
[Unit] Description=Rust Web App After=network.target <p>[Service] Type=simple User=www # 替换为你实际运行 Rust 的用户，比如 www 或 root WorkingDirectory=/www/wwwroot/your-rust-app ExecStart=/www/wwwroot/your-rust-app/target/release/your_app Restart=always RestartSec=10</p><p>[Install] WantedBy=multi-user.target
- 启用并启动：
sudo systemctl daemon-reload && sudo systemctl enable rust-app && sudo systemctl start rust-app - 查日志：
sudo journalctl -u rust-app -f，比看 nohup.out 直观得多 - 注意：service 文件里
User必须和 cargo 构建时的用户一致，否则可能因权限读不到$HOME/.cargo或证书文件
真正卡住人的地方往往不是 Rust 语法，而是 cargo build 在后台静默失败、systemd 日志里一句「Permission denied」没注意、或者 Nginx 代理时用了 localhost 却忘了 Rust 绑定的是 127.0.0.1——这些细节不盯住，反复重启服务也没用。
