Ubuntu 下把 Rust 项目部署上线,这事儿说难不难,但坑也不少。今天就把完整流程拆开揉碎了讲一遍,从环境准备到监控维护,一步不落。

1. 准备部署环境
工欲善其事,必先利其器。先给 Ubuntu 服务器把基础工具链补齐:
sudo apt update && sudo apt install -y build-essential curl git
如果你的项目依赖系统库,比如 OpenSSL,那还得装对应的开发包:
sudo apt install -y libssl-dev pkg-config
放心,这几步装完,环境基本就齐活了。
2. 构建优化后的 Release 版本
进入项目目录,执行 cargo build --release,编译出来的可执行文件默认在 target/release/ 下。不过光这样还不够,要想跑得又快又省空间,得在 Cargo.toml 里动点手脚:
[profile.release]
opt-level = "z" # 体积优先,兼顾性能
lto = true # 全局链接优化
codegen-units = 1 # 提升优化密度
panic = "abort" # 禁用栈展开,减少体积
strip = true # 自动移除调试符号(Rust 1.59+)
构建完成后,还能再压一压二进制文件的大小(纯属可选操作):
strip target/release/your_project
upx --best target/release/your_project # 需要提前装上 upx:sudo apt install upx
经过这两轮瘦身,体积能降不少,部署时传输也快。
3. 处理依赖兼容性问题
3.1 静态编译(一劳永逸)
如果不想跟目标服务器的系统库版本扯皮,直接用 musl 工具链做静态编译,完事大吉:
rustup target add x86_64-unknown-linux-musl
cargo build --release --target x86_64-unknown-linux-musl
编译完拿 ldd 验一下,看到 "not a dynamic executable" 就说明成功了:
ldd target/x86_64-unknown-linux-musl/release/your_project
不过得提个醒:静态编译出来的文件通常比动态的大 2~3 倍,换来的是超强兼容性,值不值看场景。
3.2 动态编译(省体积但得配环境)
要是你不想折腾静态编译,那就老老实实确保服务器上有项目依赖的系统库。万一遇到版本冲突,可以把依赖的源码直接打包进项目,以 openssl-sys 为例:
[dependencies.openssl-sys]
version = "0.9"
features = ["vendored"]
这样一来,编译时自动从源码构建,不再依赖系统里的 OpenSSL 版本。
4. 部署可执行文件
把编译好的二进制扔到服务器上,最直接的方式是 scp:
scp target/release/your_project user@your_server_ip:/opt/your_project
然后给上执行权限:
chmod +x /opt/your_project
到这步,程序本体已经就位了。
5. 配置环境变量
数据库连接串、API 密钥这些东西,别往代码里硬编码。临时测试可以这么干:
export DATABASE_URL="postgres://user:password@localhost:5432/dbname"
export RUST_LOG="info"
但正经部署还是建议用 .env 文件。在 /opt/your_project 下创建一个:
DATABASE_URL=postgres://user:password@localhost:5432/dbname
RUST_LOG=info
别忘了在项目的 Cargo.toml 里加上 dotenv 依赖:
[dependencies]
dotenv = "0.15"
然后在 main.rs 里加载:
use dotenv::dotenv;
fn main() {
dotenv().ok();
// 其余代码...
}
这样环境变量就能从文件中读进来,既安全又方便。
6. 使用 systemd 管理服务(强烈推荐)
想让应用开机自启、崩溃后自动复活?systemd 是 Ubuntu 上的标准答案。先创建服务文件:
sudo nano /etc/systemd/system/your_project.service
填入以下内容(记得根据实际路径和用户修改):
[Unit]
Description=Your Rust Project
After=network.target
[Service]
Type=simple
User=ubuntu # 运行项目的用户,比如 ubuntu 或 www-data
WorkingDirectory=/opt/your_project
ExecStart=/opt/your_project/your_project
Restart=on-failure # 崩溃时自动重启
RestartSec=5s # 重启间隔 5 秒
EnvironmentFile=/opt/your_project/.env # 加载环境变量
[Install]
WantedBy=multi-user.target
然后一条条执行:
sudo systemctl daemon-reload
sudo systemctl start your_project
sudo systemctl enable your_project
想看看服务跑没跑:
sudo systemctl status your_project
绿灯一亮,基本就稳了。
7. 验证部署
如果你的项目是 Web 服务,监听 8080 端口,直接在服务器上 curl 一下:
curl https://localhost:8080
或者打开浏览器访问 https://your_server_ip:8080,确认页面能正常显示。
8. 监控与维护
上线只是起点,后续的监控才是重头戏。
- 日志查看:用
journalctl实时追踪:
sudo journalctl -u your_project -f
- 性能监控:简单点用
top或htop;想上档次就搭 Prometheus + Grafana。 - 自动重启:如果没用 systemd,也可以装个
supervisord来保活。
到这里,Ubuntu 下 Rust 项目的部署上线就算打通关了。根据实际需求,静态编译、动态编译甚至容器化(Docker)都可以灵活选用,核心就一条——保证应用稳定运行。
