使用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 发布静态文件服务非常简单：

/* by 01130.hk - online tools website : 01130.hk/zh/regexdso.html */ #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 类型的映射能力：

3. 扩展

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

/* by 01130.hk - online tools website : 01130.hk/zh/regexdso.html */ #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"; } // 默认 fallback return "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-Type std::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 ，也就是二进制文件/未知类型，浏览器会强制下载。