ferronweb/ferron

这是什么？

核心功能

• 01配置简洁易读，适用于网站和反向代理。
• 02自动签发并续期 TLS 证书。
• 03请求追踪与日志条目关联，可按 trace ID 搜索。
• 04内置命令行工具，可校验和转换配置。
• 05提供 Linux、Windows、Debian/RPM 安装包及 Docker 镜像。

适用场景

• 部署带自动 HTTPS 的静态网站。
• 在内部 API 服务前部署反向代理。
• 通过追踪信息关联日志，排查生产环境中的请求问题。

快速上手

1. 1

   使用官方安装脚本在 Linux 上安装 Ferron（请按 README 运行官方安装脚本）

2. 2

   从 GitHub 克隆仓库并切换到 develop-3.x 分支

   git clone https://github.com/ferronweb/ferron -b develop-3.x
3. 3

   初始化子模块并构建工作区

   cd ferron && git submodule update --init --recursive && cargo build --workspace
4. 4

   使用配置文件运行服务器

   cargo run -p ferron -- run -c ferron.conf

使用前须知

• !预编译安装程序仅提供 Linux 版本，其他平台需要从源码构建。
• !项目目前处于 develop-3.x 版本线，默认分支可能与本版本文档不一致。

收录于专题

标签

常见问题

ferron 是什么？

基于 Rust 的 Web 服务器，配置简洁，支持自动 TLS，并可将请求追踪与日志关联起来排查问题。 Ferron 是一个用 Rust 编写的 Web 服务器，可以提供静态文件服务，也可以作为反向代理使用。配置文件简洁易读，几行即可定义一个站点或代理路由，两种用途使用同一套语法。

ferron 可以免费使用吗？用的什么许可证？

ferron 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

ferron 还在维护吗？

活跃维护中。ferron 最近一次提交是在 2026年10月23日。

ferron 适合用来做什么？

部署带自动 HTTPS 的静态网站。 在内部 API 服务前部署反向代理。 通过追踪信息关联日志，排查生产环境中的请求问题。

ferron 怎么安装和运行？

使用官方安装脚本在 Linux 上安装 Ferron（请按 README 运行官方安装脚本） 从 GitHub 克隆仓库并切换到 develop-3.x 分支: git clone https://github.com/ferronweb/ferron -b develop-3.x 初始化子模块并构建工作区: cd ferron && git submodule update --init --recursive && cargo build --workspace 使用配置文件运行服务器: cargo run -p ferron -- run -c ferron.conf

在哪里获取 ferron？

源代码和安装说明在 GitHub 上：https://github.com/ferronweb/ferron