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

charlee44

发布于 2026-03-10 08:30:22

670

文章被收录于专栏：代码编写世界代码编写世界

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";
  }
  // 默认 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 ，也就是二进制文件/未知类型，浏览器会强制下载。

本文参与腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。

原始发表：2025-12-28，如有侵权请联系 cloudcommunity@tencent.com 删除

框架