使用cpp-httplib发布静态文件服务

1. 引言

静态文件（Static Files） 是指那些内容在服务器上预先写好、不会随请求动态改变的文件，例如：

• HTML 页面（如 index.html）
• CSS 样式表（如 style.css）
• JavaScript 脚本（如 app.js）
• 图片（如 logo.png, photo.jpg）
• 字体、图标、PDF、音视频等

静态文件服务（Static File Serving） 是指 HTTP 服务器能够接收客户端（如浏览器）对某个路径的请求，并自动从本地文件系统中找到对应文件，将其内容返回给客户端。例如：

• 用户访问 http://example.com/style.css
• 服务器自动去磁盘找 ./www/style.css
• 读取文件内容，设置正确的 Content-Type: text/css
• 把文件原样返回给浏览器

这个过程无需写任何业务逻辑代码，由 HTTP 服务器框架自动完成。

一个通用的 HTTP 服务器框架通常会提供静态文件服务功能，因为：

• 实现简单：读文件 + 设置 MIME 类型即可；
• 用途广泛：极大简化小型项目部署；
• 开发体验好：不用额外起 Nginx 就能跑完整 Web 应用；
• 符合 HTTP 本质：HTTP 最初就是为传输静态文档设计的（超文本传输协议）。

2. 实例

使用 cpp-httplib 发布静态文件服务非常简单：

#include <httplib.h>#include <iostream>
#include <string>using namespace std;int main() {httplib::Server svr;svr.set_mount_point("/public", "D:/Work/HttpServer/public");std::cout << "Server listening on http://0.0.0.0:8080/public\n";svr.listen("0.0.0.0", 8080);return 0;
}

在 D:/Work/HttpServer/public 这个目录中笔者放置了一些文件：

那么可以在浏览器通过 URL 地址 http://127.0.0.1:8080/public/最小二乘问题详解1：线性最小二乘/meta.json 访问到具体的文件内容：

那么是不是所有的文件都支持访问并且加载显示呢？这取决于 HTTP 服务器（cpp-httplib）对文件扩展名与 MIME 类型的映射能力：

扩展名	MIME 类型	扩展名	MIME 类型
css	text/css	mpga	audio/mpeg
csv	text/csv	weba	audio/webm
txt	text/plain	wav	audio/wave
vtt	text/vtt	otf	font/otf
html, htm	text/html	ttf	font/ttf
apng	image/apng	woff	font/woff
avif	image/avif	woff2	font/woff2
bmp	image/bmp	7z	application/x-7z-compressed
gif	image/gif	atom	application/atom+xml
png	image/png	pdf	application/pdf
svg	image/svg+xml	mjs, js	text/javascript
webp	image/webp	json	application/json
ico	image/x-icon	rss	application/rss+xml
tif	image/tiff	tar	application/x-tar
tiff	image/tiff	xhtml, xht	application/xhtml+xml
jpeg, jpg	image/jpeg	xslt	application/xslt+xml
mp4	video/mp4	xml	application/xml
mpeg	video/mpeg	gz	application/gzip
webm	video/webm	zip	application/zip
mp3	audio/mp3	wasm	application/wasm

3. 扩展

set_mount_point 是 cpp-httplib 用于发布静态文件服务的接口，将设置的目录挂载到 HTTP Get 请求。如果将代码写的更加本质一点，就是读取相应的数据，将数据填充到 Get 请求返回：

#include <httplib.h>#include <filesystem>  // C++17
#include <fstream>
#include <iostream>
#include <nlohmann/json.hpp>
#include <string>using namespace std;
namespace fs = std::filesystem;// 辅助函数：根据文件扩展名返回 MIME 类型
std::string get_mime_type(const std::string& filename) {if (filename.ends_with(".md")) {return "text/markdown; charset=utf-8";} else if (filename.ends_with(".json")) {return "application/json; charset=utf-8";} else if (filename.ends_with(".txt")) {return "text/plain; charset=utf-8";}// 默认 fallbackreturn "application/octet-stream";
}int main() {httplib::Server svr;std::u8string docRoot =u8"D:/Work/HttpServer/public/最小二乘问题详解1：线性最小二乘";// 路由：GET /files/<filename>svr.Get(R"(/files/([^/]+))", [&](const httplib::Request& req,httplib::Response& res) {// 提取文件名（来自正则捕获组）std::string filename = req.matches[1];std::u8string u8Filename(filename.begin(), filename.end());// 安全检查：防止路径穿越（如 ../../etc/passwd）if (filename.find("..") != std::string::npos || filename.empty()) {res.status = 400;res.set_content(R"({"error": "Invalid filename"})", "application/json");return;}// 构建完整路径fs::path filepath = fs::path(docRoot) / u8Filename;// 检查文件是否存在且是普通文件if (!fs::exists(filepath) || !fs::is_regular_file(filepath)) {res.status = 404;res.set_content(R"({"error": "File not found"})", "application/json");return;}// 读取文件内容std::ifstream file(filepath, std::ios::binary);if (!file) {res.status = 500;res.set_content(R"({"error": "Failed to read file"})","application/json");return;}std::string content((std::istreambuf_iterator<char>(file)),std::istreambuf_iterator<char>());// 设置 Content-Typestd::string mime = get_mime_type(filename);res.set_content(content, mime);});std::cout << "Server listening on http://0.0.0.0:8080/files/<filename>\n";svr.listen("0.0.0.0", 8080);return 0;
}

如果我们在浏览器地址访问http://127.0.0.1:8080/files/最小二乘问题详解1：线性最小二乘.md，就可以看到最小二乘问题详解1：线性最小二乘.md这个文件的内容：

这是因为这里将 .md 文件的 MIME 设置成了 text/markdown，浏览器会按照文本格式显示 .md 文件的内容。而在 set_mount_point 接口中，由于不识别 .md 格式类型，MIME 类型会回退回 application/octet-stream ，也就是二进制文件/未知类型，浏览器会强制下载。