如何使用Dokku部署Rust Axum API？部署遇构建失败求解决

常见原因及修复步骤 #

1. 确认Dockerfile的位置和命名 #

Dokku会优先找项目根目录下大写开头的Dockerfile，如果文件放在子目录、或者命名成小写dockerfile，Dokku会跳过Docker构建流程，转而用herokuish匹配语言buildpack，最终因找不到合适的buildpack报错。

给你一个适配Axum的Dockerfile示例，直接放在项目根目录即可：

# 构建阶段：用官方Rust镜像编译代码
FROM rust:1.70 as builder
WORKDIR /app
COPY . .
# 编译生产环境版本
RUN cargo build --release

# 运行阶段：用轻量Debian镜像减少体积
FROM debian:bookworm-slim
# 安装证书，避免HTTPS请求失败
RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates
WORKDIR /app
# 从构建镜像复制编译好的可执行文件
COPY --from=builder /app/target/release/your-api-binary .
# Axum默认监听3000端口，需暴露给Dokku
EXPOSE 3000
# 启动API服务
CMD ["./your-api-binary"]

记得把your-api-binary替换成你Cargo.toml中name字段对应的可执行文件名。

2. 手动指定Docker Buildpack #

如果Dokku未自动识别Dockerfile，可强制指定使用docker buildpack：

• 本地执行命令设置：

dokku buildpacks:set your-app-name docker

• 或者在项目根目录新建.buildpacks文件，内容仅一行：

https://github.com/dokku/buildpack-docker.git

提交该文件到Git仓库后重新推送部署。

3. 检查Dockerfile是否已提交到Git #

确保Dockerfile已添加并提交到Git仓库，否则推送时Dokku服务器无法获取到该文件：

git add Dockerfile
git commit -m "Add deployment Dockerfile"
git push dokku main

4. 查看详细构建日志排查 #

若以上方法无效，可查看Dokku详细构建日志定位问题：

dokku logs your-app-name -t

或手动触发构建并查看实时输出：

dokku git:sync your-app-name https://github.com/your/repo.git main
dokku build your-app-name

内容的提问来源于stack exchange，提问作者Answary Aidan