<?xml version="1.0" encoding="utf-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" version="2.0"><channel><title>软角落-SoftNook</title><link>https://zelig.cn/</link><description>Good Luck To You!</description><item><title>Pascal HFS：用 Pascal 写 HTTP 文件服务器</title><link>https://zelig.cn/delphi/1528.html</link><description>&lt;p&gt;&lt;img src=&quot;/zb_users/upload/2026/11/202611121840240e6405dae393.png&quot; alt=&quot;Pascal HFS：用 Pascal 写 HTTP 文件服务器&quot;&gt;&lt;/p&gt;&lt;h1 id=&quot;pascal-hfs-用-pascal-写-http-文件服务器&quot;&gt;Pascal HFS：用 Pascal 写 HTTP 文件服务器&lt;/h1&gt;

&lt;blockquote&gt;
&lt;p&gt;项目地址：&lt;a href=&quot;https://github.com/drapid/HFS&quot;&gt;https://github.com/drapid/HFS&lt;/a&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2 id=&quot;一-这是什么&quot;&gt;一、这是什么&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;HFS&lt;/strong&gt;（HTTP File Server）是一个用 &lt;strong&gt;Free Pascal&lt;/strong&gt; 编写的轻量级 HTTP 文件服务器。它最典型的用法是：在本地跑一个小服务，把某个目录通过 HTTP 暴露出来，然后浏览器或其他客户端就能直接浏览、下载目录里的文件。&lt;/p&gt;

&lt;p&gt;对于习惯 Pascal / Delphi / Free Pascal 生态的开发者来说，这是一个非常&amp;rdquo;顺手&amp;rdquo;的工具——它不依赖 .NET、Java 或 Node.js 那套运行时，编译出来就是一个原生可执行文件，启动即用。仓库名里的 &lt;code&gt;drapid/HFS&lt;/code&gt; 正是这一实现的源码托管地址。&lt;/p&gt;

&lt;h2 id=&quot;二-为什么值得关注&quot;&gt;二、为什么值得关注&lt;/h2&gt;

&lt;p&gt;在文件服务器这个领域，市面上的选择很多（Python 的 &lt;code&gt;http.server&lt;/code&gt;、Nginx、Caddy、各种 Go 写的单文件服务）。HFS 的价值不在于&amp;rdquo;重新发明轮子&amp;rdquo;，而在于它契合了特定人群的工作方式：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;原生二进制、零依赖部署&lt;/strong&gt;：用 Free Pascal 编译后得到单文件可执行程序，拷到目标机器上直接运行，不需要用户先装一套运行时环境。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;对 Pascal 开发者友好&lt;/strong&gt;：源码可读、可改，想加一个目录鉴权、想换成自己的日志格式，直接改源码重新编译即可，学习成本极低。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;轻量&lt;/strong&gt;：面向&amp;rdquo;局域网/内网快速共享目录&amp;rdquo;这类场景，没有复杂的配置体系，目标是把事情做简单。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;跨平台&lt;/strong&gt;：依托 Free Pascal 的跨平台能力，同一套源码可以在 Windows / Linux / macOS 等平台编译运行。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;适合教学与二次开发&lt;/strong&gt;：它是一个完整可运行的小项目，涉及 HTTP 协议处理、Socket 编程、文件系统遍历、目录列表 HTML 生成等，是学习&amp;rdquo;用 Pascal 写网络服务&amp;rdquo;的良好样本。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;三-技术栈与实现要点&quot;&gt;三、技术栈与实现要点&lt;/h2&gt;

&lt;p&gt;HFS 基于 &lt;strong&gt;Free Pascal（FPC）&lt;/strong&gt; 构建，通常会配合 Lazarus 生态里常用的网络库来搭建服务端。整体结构可以概括为几个层次：&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;监听层&lt;/strong&gt;：基于 TCP Socket 接受连接，读取 HTTP 请求行与头部。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;路由/处理层&lt;/strong&gt;：解析请求方法与路径，区分&amp;rdquo;目录浏览&amp;rdquo;与&amp;rdquo;文件下载&amp;rdquo;两种主要行为。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;文件系统层&lt;/strong&gt;：把 URL 路径安全地映射到磁盘路径，做路径规范化与越界检查（防止 &lt;code&gt;../&lt;/code&gt; 目录穿越），遍历目录生成列表。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;响应层&lt;/strong&gt;：文件下载时输出正确的 &lt;code&gt;Content-Type&lt;/code&gt;、&lt;code&gt;Content-Length&lt;/code&gt;，并支持流式读取，避免大文件一次性读入内存；目录浏览时生成 HTML 页面返回给浏览器。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;从工程实践角度看，这类项目的关键难点往往不在&amp;rdquo;能跑起来&amp;rdquo;，而在于几个细节：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;路径安全&lt;/strong&gt;：必须严格限制访问范围在根目录之内，拒绝任何形式的目录穿越。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;MIME 类型&lt;/strong&gt;：为常见扩展名映射正确的 &lt;code&gt;Content-Type&lt;/code&gt;，否则浏览器可能把文件当成下载或错误渲染。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;大文件与并发&lt;/strong&gt;：分块读取、合理设置缓冲区，避免内存暴涨；同时要考虑多连接下的资源管理。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;编码问题&lt;/strong&gt;：中文路径、非 ASCII 文件名的 URL 编码与解码，是跨平台场景里最容易踩的坑之一。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;四-典型使用场景&quot;&gt;四、典型使用场景&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;内网快速共享&lt;/strong&gt;：在工作机或开发服务器上临时开一个目录，同事用浏览器访问即可下载文件，不必配置 FTP 或搭建完整 Web 服务。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;构建产物分发&lt;/strong&gt;：CI 打包后启动 HFS 指向产物目录，供测试或部署脚本通过 HTTP 拉取。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;嵌入式/离线环境&lt;/strong&gt;：在没有包管理器、没有运行时环境的设备上，塞一个静态编译的 HFS 可执行文件就能提供文件服务。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;学习与实验&lt;/strong&gt;：作为 HTTP 服务器原理的&amp;rdquo;活教材&amp;rdquo;，读源码比读文档更直观。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;五-上手方式&quot;&gt;五、上手方式&lt;/h2&gt;

&lt;p&gt;基本流程与其它 Free Pascal 项目一致：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;git clone https://github.com/drapid/HFS.git
cd HFS
# 使用 Free Pascal 编译（具体命令以仓库说明为准）
fpc hfs.pas&lt;/pre&gt;

&lt;p&gt;编译得到可执行文件后，通过命令行参数或配置文件指定要共享的根目录与监听端口，然后浏览器访问 &lt;code&gt;http://localhost:&amp;lt;端口&amp;gt;/&lt;/code&gt; 即可浏览目录。&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;说明：具体编译参数、命令行选项与配置格式请以仓库 README 和源码为准，不同版本可能有差异。&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2 id=&quot;六-与同类工具的定位对比&quot;&gt;六、与同类工具的定位对比&lt;/h2&gt;

&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;工具&lt;/th&gt;
&lt;th&gt;运行时依赖&lt;/th&gt;
&lt;th&gt;二进制约&lt;/th&gt;
&lt;th&gt;适合人群&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;

&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Python &lt;code&gt;http.server&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;需 Python&lt;/td&gt;
&lt;td&gt;—&lt;/td&gt;
&lt;td&gt;有 Python 环境的机器&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;Nginx/Caddy&lt;/td&gt;
&lt;td&gt;需安装与配置&lt;/td&gt;
&lt;td&gt;有&lt;/td&gt;
&lt;td&gt;面向生产、需要完整 Web 能力&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;Go 单文件服务&lt;/td&gt;
&lt;td&gt;无&lt;/td&gt;
&lt;td&gt;有&lt;/td&gt;
&lt;td&gt;偏好 Go 生态&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Pascal HFS&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;无（静态编译）&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;有&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Pascal 开发者、嵌入式/离线环境、想改源码的人&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;HFS 的真正竞争力是&amp;rdquo;&lt;strong&gt;源码在我熟悉的语言里&lt;/strong&gt;&amp;ldquo;这一条——需要定制时，改动成本几乎为零。&lt;/p&gt;

&lt;h2 id=&quot;七-可改进的方向-如果你想参与&quot;&gt;七、可改进的方向（如果你想参与）&lt;/h2&gt;

&lt;p&gt;对于打算基于它做二次开发的人，以下几个方向都比较有价值：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;增加&lt;strong&gt;基础认证&lt;/strong&gt;（HTTP Basic Auth 或简单的凭据配置）。&lt;/li&gt;
&lt;li&gt;支持&lt;strong&gt;断点续传&lt;/strong&gt;（&lt;code&gt;Range&lt;/code&gt; 请求）。&lt;/li&gt;
&lt;li&gt;提供&lt;strong&gt;上传接口&lt;/strong&gt;或简易 Web 表单（需要谨慎处理安全）。&lt;/li&gt;
&lt;li&gt;改进&lt;strong&gt;目录列表的 UI 与文件名编码处理&lt;/strong&gt;。&lt;/li&gt;
&lt;li&gt;加入&lt;strong&gt;访问日志&lt;/strong&gt;与&lt;strong&gt;限速&lt;/strong&gt;。&lt;/li&gt;
&lt;li&gt;补充&lt;strong&gt;自动化测试&lt;/strong&gt;，覆盖路径穿越、MIME 映射等边界情况。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;八-小结&quot;&gt;八、小结&lt;/h2&gt;

&lt;p&gt;Pascal HFS 是一个&amp;rdquo;小而完整&amp;rdquo;的项目：它把一个 HTTP 文件服务器该有的核心环节——监听、路由、路径安全、文件流式传输、目录列表——都用 Pascal 实现了一遍。对于 Pascal 社区而言，它是实践现代网络编程的实用工具；对于普通用户而言，它是一个无需运行时、拷过去就能用的轻量文件共享方案。如果你恰好在这个生态里，它值得克隆下来读一读、跑一跑。&lt;/p&gt;

&lt;hr&gt;

&lt;p&gt;&lt;strong&gt;仓库地址&lt;/strong&gt;：&lt;a href=&quot;https://github.com/drapid/HFS&quot;&gt;https://github.com/drapid/HFS&lt;/a&gt;&lt;/p&gt;
</description><pubDate>Sun, 22 Nov 2026 20:52:17 +0800</pubDate></item><item><title>Golang-Go 语言 WebDAV 服务器：hacdias/webdav 完整指南</title><link>https://zelig.cn/golang/1527.html</link><description>&lt;p&gt;&lt;img src=&quot;/zb_users/upload/2026/11/20261112190022fc587c799746.svg&quot; alt=&quot;Golang-Go 语言 WebDAV 服务器：hacdias/webdav 完整指南&quot;&gt;&lt;/p&gt;&lt;h1 id=&quot;go-语言-webdav-服务器-hacdias-webdav-完整指南&quot;&gt;Go 语言 WebDAV 服务器：hacdias/webdav 完整指南&lt;/h1&gt;

&lt;blockquote&gt;
&lt;p&gt;一个用 Go 编写的轻量级、跨平台、单文件的 WebDAV 服务器&lt;/p&gt;

&lt;p&gt;项目地址：&lt;a href=&quot;https://github.com/hacdias/webdav&quot;&gt;https://github.com/hacdias/webdav&lt;/a&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;hr&gt;

&lt;h2 id=&quot;一-什么是-webdav&quot;&gt;一、什么是 WebDAV？&lt;/h2&gt;

&lt;p&gt;WebDAV（Web Distributed Authoring and Versioning）是 HTTP 协议的扩展，允许客户端像操作本地文件系统一样对远程服务器上的文件进行增、删、改、查、移动、复制等操作。&lt;/p&gt;

&lt;p&gt;它最大的价值在于&lt;strong&gt;跨平台文件共享&lt;/strong&gt;：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Windows 资源管理器可以直接&amp;rdquo;映射网络驱动器&amp;rdquo;&lt;/li&gt;
&lt;li&gt;macOS Finder 可以&amp;rdquo;连接到服务器&amp;rdquo;&lt;/li&gt;
&lt;li&gt;iOS/Android 各类 App（如 Documents、nPlayer、Fileball）都原生支持&lt;/li&gt;
&lt;li&gt;各类同步工具（rclone、Cyberduck）也都能对接&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;而 &lt;strong&gt;hacdias/webdav&lt;/strong&gt; 正是在这个场景下非常出色的一个开源实现。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;二-项目简介&quot;&gt;二、项目简介&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;hacdias/webdav&lt;/strong&gt; 是用 Go 语言编写的 WebDAV 服务器，作者是 &lt;strong&gt;Henrique Dias&lt;/strong&gt;。它以一个&lt;strong&gt;单一可执行二进制文件&lt;/strong&gt;的形式发布，零依赖、开箱即用，非常适合个人搭建私有文件服务。&lt;/p&gt;

&lt;h3 id=&quot;核心特点&quot;&gt;核心特点&lt;/h3&gt;

&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;特性&lt;/th&gt;
&lt;th&gt;说明&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;

&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;🚀 &lt;strong&gt;单文件部署&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;编译后只有一个二进制文件，无需任何运行时依赖&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;🗂️ &lt;strong&gt;跨平台&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Linux / Windows / macOS / FreeBSD 全覆盖（含 ARM 架构）&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;🔐 &lt;strong&gt;认证支持&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;内置 Basic Auth，支持多用户与密码哈希&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;🌐 &lt;strong&gt;TLS/HTTPS&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;支持原生证书与 Let&amp;rsquo;s Encrypt 自动签发&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;👥 &lt;strong&gt;多用户与权限&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;可配置多个账户，独立目录、独立权限&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;📁 &lt;strong&gt;权限控制&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;支持读、写、目录列表、相对路径等细粒度开关&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;🧩 &lt;strong&gt;CORS 支持&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;方便前后端分离的 Web 应用对接&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;⚙️ &lt;strong&gt;YAML 配置&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;配置清晰、人类可读&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;📊 &lt;strong&gt;日志与代理&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;内置日志，支持反向代理头处理&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;它本质上是基于 &lt;code&gt;golang.org/x/net/webdav&lt;/code&gt; 包的&lt;strong&gt;封装与管理层&lt;/strong&gt;，把复杂的配置、权限、认证都做成了易用的方案。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;三-快速上手&quot;&gt;三、快速上手&lt;/h2&gt;

&lt;h3 id=&quot;1-安装方式&quot;&gt;1. 安装方式&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;方式一：直接下载二进制&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;从 &lt;a href=&quot;https://github.com/hacdias/webdav/releases&quot;&gt;Releases&lt;/a&gt; 下载对应平台的二进制即可。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;方式二：使用 Go 安装&lt;/strong&gt;&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;go install github.com/hacdias/webdav/v5@latest&lt;/pre&gt;

&lt;p&gt;&lt;strong&gt;方式三：Docker&lt;/strong&gt;&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;docker run -p 6065:6065 \
  -v /path/to/data:/data \
  -v /path/to/config.yml:/config.yml \
  ghcr.io/hacdias/webdav -c /config.yml&lt;/pre&gt;

&lt;p&gt;&lt;strong&gt;方式四：包管理器&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;macOS：&lt;code&gt;brew install webdav&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Arch Linux：&lt;code&gt;yay -S webdav&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;2-最小配置&quot;&gt;2. 最小配置&lt;/h3&gt;

&lt;p&gt;创建 &lt;code&gt;config.yaml&lt;/code&gt;：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;YAML&quot;&gt;YAML&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-yaml prism-line-numbers&quot; data-language=&quot;YAML&quot;&gt;address: 0.0.0.0
port: 6065
directory: /var/webdav

users:
  - username: admin
    password: admin123&lt;/pre&gt;

&lt;p&gt;启动：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;webdav --config config.yaml&lt;/pre&gt;

&lt;p&gt;访问 &lt;code&gt;http://localhost:6065&lt;/code&gt; 即可。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;四-配置详解&quot;&gt;四、配置详解&lt;/h2&gt;

&lt;p&gt;hacdias/webdav 的配置文件采用 YAML 格式，功能项覆盖得相当全面。下面列几个常用的配置项。&lt;/p&gt;

&lt;h3 id=&quot;全局配置&quot;&gt;全局配置&lt;/h3&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;YAML&quot;&gt;YAML&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-yaml prism-line-numbers&quot; data-language=&quot;YAML&quot;&gt;# 监听地址与端口
address: 0.0.0.0
port: 6065

# WebDAV 根目录（默认 ./data）
directory: /var/webdav

# 是否允许修改（全局开关）
modify: true

# 日志级别：error / info / debug
log:
  format: console   # console 或 json
  level: info

# 是否信任反向代理的 X-Forwarded-* 头
# 部署在 Nginx/Caddy 后建议设为 true
behindProxy: false

# 是否启用 CORS
cors:
  enabled: true
  allowed_headers:
    - Authorization
  allowed_hosts:
    - https://example.com

# TLS 支持
tls: false
cert: cert.pem
key: key.pem

# Let&#039;s Encrypt 自动证书
# tls: true
# cert: /path/to/cache&lt;/pre&gt;

&lt;h3 id=&quot;用户级配置&quot;&gt;用户级配置&lt;/h3&gt;

&lt;p&gt;每个用户都可以拥有自己独立的目录与权限：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;YAML&quot;&gt;YAML&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-yaml prism-line-numbers&quot; data-language=&quot;YAML&quot;&gt;users:
  - username: admin
    password: admin     # 明文密码
    directory: /data/admin
    scope: /            # 限定访问子路径，如 /home
    modify: true        # 是否允许写
    rules: &amp;quot;&amp;quot;           # 规则文件（可选）

  - username: reader
    # 密码支持 bcrypt 哈希，避免明文
    password: &amp;quot;$2y$10$...&amp;quot;
    directory: /data/readonly
    modify: false
    permissions: R      # R = 只读；CRUD 全部权限

  - username: guest
    directory: /data/public
    permissions: R&lt;/pre&gt;

&lt;h3 id=&quot;权限说明&quot;&gt;权限说明&lt;/h3&gt;

&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;权限&lt;/th&gt;
&lt;th&gt;含义&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;

&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;R&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Read（读取）&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;code&gt;C&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Create（新建）&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;code&gt;U&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Update（修改）&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;code&gt;D&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Delete（删除）&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;组合写法如 &lt;code&gt;RU&lt;/code&gt;、&lt;code&gt;CRUD&lt;/code&gt;，若不指定则默认允许全部。&lt;/p&gt;

&lt;h3 id=&quot;生成-bcrypt-密码&quot;&gt;生成 bcrypt 密码&lt;/h3&gt;

&lt;p&gt;推荐使用哈希密码而非明文。可用 htpasswd 生成：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;htpasswd -bnBC 10 &amp;quot;&amp;quot; yourpassword | tr -d &#039;:\n&#039;&lt;/pre&gt;

&lt;p&gt;或者在 Go 代码里：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Go&quot;&gt;Go&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-go prism-line-numbers&quot; data-language=&quot;Go&quot;&gt;import &amp;quot;golang.org/x/crypto/bcrypt&amp;quot;

hash, _ := bcrypt.GenerateFromPassword([]byte(&amp;quot;yourpassword&amp;quot;), bcrypt.DefaultCost)&lt;/pre&gt;

&lt;hr&gt;

&lt;h2 id=&quot;五-实践场景&quot;&gt;五、实践场景&lt;/h2&gt;

&lt;h3 id=&quot;场景一-家庭-nas-共享&quot;&gt;场景一：家庭 NAS 共享&lt;/h3&gt;

&lt;p&gt;在家用树莓派或旧电脑上跑一个 Docker 容器即可：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;YAML&quot;&gt;YAML&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-yaml prism-line-numbers&quot; data-language=&quot;YAML&quot;&gt;version: &#039;3&#039;
services:
  webdav:
    image: ghcr.io/hacdias/webdav:latest
    restart: always
    ports:
      - 6065:6065
    volumes:
      - ./data:/data
      - ./config.yaml:/config.yaml
    command: -c /config.yaml&lt;/pre&gt;

&lt;p&gt;Windows 资源管理器里&amp;rdquo;映射网络驱动器&amp;rdquo;，填 &lt;code&gt;http://你的IP:6065&lt;/code&gt; 就能用，就像操作本地硬盘一样。&lt;/p&gt;

&lt;h3 id=&quot;场景二-反向代理-https&quot;&gt;场景二：反向代理 + HTTPS&lt;/h3&gt;

&lt;p&gt;生产环境强烈建议放在 Caddy 或 Nginx 后面，自动获得 HTTPS：&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Caddy 示例：&lt;/strong&gt;&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Plain text&quot;&gt;Plain text&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-plaintext prism-line-numbers&quot; data-language=&quot;Plain text&quot;&gt;files.example.com {
    reverse_proxy localhost:6065
}&lt;/pre&gt;

&lt;p&gt;同时要在配置里开启 &lt;code&gt;behindProxy: true&lt;/code&gt;，否则 WebDAV 的 &lt;code&gt;Location&lt;/code&gt; 重定向可能出错。&lt;/p&gt;

&lt;h3 id=&quot;场景三-多用户隔离&quot;&gt;场景三：多用户隔离&lt;/h3&gt;

&lt;p&gt;一机多用户，各自目录独立、权限独立：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;YAML&quot;&gt;YAML&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-yaml prism-line-numbers&quot; data-language=&quot;YAML&quot;&gt;address: 0.0.0.0
port: 6065
directory: /data

users:
  - username: alice
    password: &amp;quot;xxx&amp;quot;
    directory: /data/alice
    permissions: CRUD

  - username: bob
    password: &amp;quot;yyy&amp;quot;
    directory: /data/bob
    permissions: CRUD

  - username: guest
    password: &amp;quot;guest&amp;quot;
    directory: /data/public
    permissions: R&lt;/pre&gt;

&lt;h3 id=&quot;场景四-与-rclone-结合&quot;&gt;场景四：与 rclone 结合&lt;/h3&gt;

&lt;p&gt;rclone 直接支持 WebDAV 协议，一条命令就能挂载：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;rclone config
# 选择 webdav，填入地址、用户名、密码后

# 挂载到本地目录
rclone mount mywebdav: /mnt/webdav --vfs-cache-mode writes&lt;/pre&gt;

&lt;p&gt;配合 rclone 你还可以轻松实现与 S3、Google Drive、OneDrive 之间的同步。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;六-源码结构一览&quot;&gt;六、源码结构一览&lt;/h2&gt;

&lt;p&gt;对于想了解内部实现或做二次开发的开发者，可以快速浏览下源码结构。项目本身相当精简：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Plain text&quot;&gt;Plain text&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-plaintext prism-line-numbers&quot; data-language=&quot;Plain text&quot;&gt;.
├── main.go             # 入口，处理 flag 与配置加载
├── cmd/                # 命令与配置解析
│   ├── config.go       # 配置结构体定义
│   └── ...
├── lib/                # 核心逻辑
│   ├── handler.go      # WebDAV handler 封装、认证拦截
│   ├── rule.go         # 规则引擎
│   └── ...
└── ...&lt;/pre&gt;

&lt;p&gt;&lt;strong&gt;核心思路&lt;/strong&gt;：&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;code&gt;main.go&lt;/code&gt; 解析 &lt;code&gt;-c&lt;/code&gt; 参数，读取 YAML&lt;/li&gt;
&lt;li&gt;&lt;code&gt;cmd.Config&lt;/code&gt; 反序列化配置&lt;/li&gt;
&lt;li&gt;根据用户配置构造若干个 &lt;code&gt;webdav.Handler&lt;/code&gt;（每个用户一份）&lt;/li&gt;
&lt;li&gt;通过自定义 &lt;code&gt;http.Handler&lt;/code&gt; 做认证拦截，按用户选择对应的 &lt;code&gt;Handler&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;golang.org/x/net/webdav&lt;/code&gt; 提供了底层 WebDAV 协议实现（&lt;code&gt;FileSystem&lt;/code&gt; + &lt;code&gt;LockSystem&lt;/code&gt;）&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;其中特别值得注意的是&lt;strong&gt;规则引擎&lt;/strong&gt;：可以在配置里针对路径、方法、用户设定允许或拒绝的规则，实现比&amp;rdquo;全局读写开关&amp;rdquo;更细的控制。这在团队协作或半公开共享时会非常有用。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;七-优点与局限&quot;&gt;七、优点与局限&lt;/h2&gt;

&lt;h3 id=&quot;优点&quot;&gt;优点&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;✅ &lt;strong&gt;极简&lt;/strong&gt;：单个二进制文件，部署成本极低&lt;/li&gt;
&lt;li&gt;✅ &lt;strong&gt;安全渐进&lt;/strong&gt;：支持 bcrypt 哈希密码、HTTPS、权限控制&lt;/li&gt;
&lt;li&gt;✅ &lt;strong&gt;协议标准&lt;/strong&gt;：基于官方 &lt;code&gt;x/net/webdav&lt;/code&gt;，兼容性可靠&lt;/li&gt;
&lt;li&gt;✅ &lt;strong&gt;活跃维护&lt;/strong&gt;：作者持续更新，社区生态完善&lt;/li&gt;
&lt;li&gt;✅ &lt;strong&gt;容器友好&lt;/strong&gt;：有官方 Docker 镜像&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;局限&quot;&gt;局限&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;⚠️ &lt;strong&gt;无 Web 界面&lt;/strong&gt;：纯 WebDAV 后端，不能直接在浏览器里浏览（需要搭配第三方 UI 或用系统客户端）&lt;/li&gt;
&lt;li&gt;⚠️ &lt;strong&gt;单机为主&lt;/strong&gt;：没有分布式或多节点方案，文件存在本地&lt;/li&gt;
&lt;li&gt;⚠️ &lt;strong&gt;无版本控制&lt;/strong&gt;：不具备快照、版本历史等高级功能&lt;/li&gt;
&lt;li&gt;⚠️ &lt;strong&gt;规则引擎相对复杂&lt;/strong&gt;：进阶配置有一定学习曲线&lt;/li&gt;
&lt;/ul&gt;

&lt;hr&gt;

&lt;h2 id=&quot;八-一些实用建议&quot;&gt;八、一些实用建议&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;生产环境务必使用 HTTPS&lt;/strong&gt;：WebDAV 传输密码和文件，明文 HTTP 风险极大&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;用 bcrypt 哈希密码&lt;/strong&gt;，避免配置文件泄露导致密码裸奔&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;反向代理记得开 &lt;code&gt;behindProxy&lt;/code&gt;&lt;/strong&gt;，不然重定向 URL 会指向内网地址&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;限制 &lt;code&gt;directory&lt;/code&gt; 不要覆盖系统重要目录&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;给访客账户用 &lt;code&gt;R&lt;/code&gt; 权限&lt;/strong&gt;，防止被意外写入或删除&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;搭配 rclone / Restic / Duplicati 等工具&lt;/strong&gt;，可以做自动化备份、跨云同步&lt;/li&gt;
&lt;/ol&gt;

&lt;hr&gt;

&lt;h2 id=&quot;九-总结&quot;&gt;九、总结&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;hacdias/webdav&lt;/code&gt; 用极简的方式把&amp;rdquo;构建一个可靠 WebDAV 服务器&amp;rdquo;这件事做到了极致——&lt;strong&gt;一个二进制文件，一份 YAML 配置，就能在几分钟内搭建起一个功能完整、可控可管的私有文件服务&lt;/strong&gt;。&lt;/p&gt;

&lt;p&gt;对于想摆脱公共网盘、搭建私有云盘、做跨设备文件同步的开发者来说，它是一个非常值得考虑的选择。而对于 Go 开发者来说，它的源码也是学习&amp;rdquo;如何用 Go 写一个生产级的 HTTP 服务&amp;rdquo;的优秀范例——代码精简、职责清晰、封装得当。&lt;/p&gt;

&lt;hr&gt;

&lt;p&gt;&lt;strong&gt;参考链接：&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;项目主页：&lt;a href=&quot;https://github.com/hacdias/webdav&quot;&gt;https://github.com/hacdias/webdav&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;官方文档：&lt;a href=&quot;https://github.com/hacdias/webdav#readme&quot;&gt;https://github.com/hacdias/webdav#readme&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;x/net/webdav&lt;/code&gt;：&lt;a href=&quot;https://pkg.go.dev/golang.org/x/net/webdav&quot;&gt;https://pkg.go.dev/golang.org/x/net/webdav&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;rclone WebDAV：&lt;a href=&quot;https://rclone.org/webdav/&quot;&gt;https://rclone.org/webdav/&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</description><pubDate>Sun, 22 Nov 2026 09:34:17 +0800</pubDate></item><item><title>Golang-up：一键部署无服务器应用的神器</title><link>https://zelig.cn/golang/1526.html</link><description>&lt;p&gt;&lt;img src=&quot;/zb_users/upload/2026/11/20261112190007d76bdafa9ae5.svg&quot; alt=&quot;Golang-up：一键部署无服务器应用的神器&quot;&gt;&lt;/p&gt;&lt;h1 id=&quot;up-一键部署无服务器应用的神器&quot;&gt;up：一键部署无服务器应用的神器&lt;/h1&gt;

&lt;blockquote&gt;
&lt;p&gt;项目地址：&lt;a href=&quot;https://github.com/apex/up&quot;&gt;https://github.com/apex/up&lt;/a&gt;
项目状态：&lt;strong&gt;已归档（Archived）&lt;/strong&gt;，仅供学习参考&lt;/p&gt;
&lt;/blockquote&gt;

&lt;hr&gt;

&lt;h2 id=&quot;一-项目简介&quot;&gt;一、项目简介&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;up&lt;/strong&gt; 是 Apex 团队开发的一个 Go 语言编写的命令行工具，用于&lt;strong&gt;将无服务器应用（Serverless）一键部署到 AWS Lambda 与 API Gateway&lt;/strong&gt;。&lt;/p&gt;

&lt;p&gt;它的核心设计理念只有一个：&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;用一条命令，把任意能处理 HTTP 请求的应用部署到云上。&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;你不需要写 &lt;code&gt;serverless.yml&lt;/code&gt;，不需要手动打包 zip，不需要配置 API Gateway 映射，不需要理解 Lambda 的部署包结构。只需在项目根目录执行：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;up&lt;/pre&gt;

&lt;p&gt;应用就上线了，并自动分配一个 HTTPS 域名。&lt;/p&gt;

&lt;p&gt;在 2017 年前后 Serverless 尚未成熟的年代，这是一个相当先锋的想法，也积累了超过 1 万颗 Star。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;二-设计哲学&quot;&gt;二、设计哲学&lt;/h2&gt;

&lt;h3 id=&quot;1-零配置-zero-config&quot;&gt;1. 零配置（Zero-config）&lt;/h3&gt;

&lt;p&gt;&lt;code&gt;up&lt;/code&gt; 会&lt;strong&gt;自动检测项目类型&lt;/strong&gt;。只要目录里有 &lt;code&gt;main.go&lt;/code&gt;、&lt;code&gt;app.js&lt;/code&gt;、&lt;code&gt;index.js&lt;/code&gt;、&lt;code&gt;package.json&lt;/code&gt;、&lt;code&gt;Gemfile&lt;/code&gt;、&lt;code&gt;Pipfile&lt;/code&gt;、&lt;code&gt;requirements.txt&lt;/code&gt; 等任一标志文件，它就知道该怎么构建和部署。&lt;/p&gt;

&lt;h3 id=&quot;2-关注点分离&quot;&gt;2. 关注点分离&lt;/h3&gt;

&lt;p&gt;你只需要关心业务代码，&lt;code&gt;up&lt;/code&gt; 负责：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;依赖安装与打包&lt;/li&gt;
&lt;li&gt;二进制/运行时构建&lt;/li&gt;
&lt;li&gt;Lambda 函数创建与更新&lt;/li&gt;
&lt;li&gt;API Gateway 路由绑定&lt;/li&gt;
&lt;li&gt;自定义域名与 TLS 证书配置&lt;/li&gt;
&lt;li&gt;日志（log）与指标（metrics）查看&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;3-单命令体验&quot;&gt;3. 单命令体验&lt;/h3&gt;

&lt;p&gt;&lt;code&gt;up&lt;/code&gt;、&lt;code&gt;up deploy production&lt;/code&gt;、&lt;code&gt;up logs -f&lt;/code&gt;、&lt;code&gt;up url&lt;/code&gt; 这类命令覆盖了从开发到运维的全流程。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;三-核心特性&quot;&gt;三、核心特性&lt;/h2&gt;

&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;特性&lt;/th&gt;
&lt;th&gt;说明&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;

&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;多语言支持&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Node.js、Go、Python、Java、Crystal、静态站点等&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;单命令部署&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;up&lt;/code&gt; 一条命令即可部署&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;自定义域名&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;自动申请与续期 Let&amp;rsquo;s Encrypt 证书，绑定 HTTPS 域名&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;环境管理&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;支持 &lt;code&gt;staging&lt;/code&gt;、&lt;code&gt;production&lt;/code&gt; 等多环境隔离&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;日志流&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;up logs -f&lt;/code&gt; 实时跟踪 Lambda 日志&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;指标观测&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;up metrics&lt;/code&gt; 查看调用、延迟、错误、冷启动&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Stack 支持&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;通过 &lt;code&gt;up.json&lt;/code&gt; 组合多个服务为一个 Stack&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;本地调用&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;up start&lt;/code&gt; 本地模拟 Lambda 环境&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;CORS / 重定向 / 静态资源&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;通过 &lt;code&gt;up.json&lt;/code&gt; 声明式配置&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;无状态回退&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;请求代理转发到其他服务（&lt;code&gt;proxy&lt;/code&gt;）&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;

&lt;hr&gt;

&lt;h2 id=&quot;四-安装方式&quot;&gt;四、安装方式&lt;/h2&gt;

&lt;p&gt;由于项目已归档，官方发布可能不再更新，但仍可通过旧版本安装：&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;macOS / Linux：&lt;/strong&gt;&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;curl -sf https://up.apex.sh/install | sh&lt;/pre&gt;

&lt;p&gt;&lt;strong&gt;通过 Go 从源码构建：&lt;/strong&gt;&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;go install github.com/apex/up/cmd/up@latest&lt;/pre&gt;

&lt;blockquote&gt;
&lt;p&gt;需要配置 AWS 凭证（&lt;code&gt;AWS_ACCESS_KEY_ID&lt;/code&gt; / &lt;code&gt;AWS_SECRET_ACCESS_KEY&lt;/code&gt;），且账号需具备 Lambda、IAM、API Gateway、ACM 等权限。&lt;/p&gt;
&lt;/blockquote&gt;

&lt;hr&gt;

&lt;h2 id=&quot;五-快速上手&quot;&gt;五、快速上手&lt;/h2&gt;

&lt;h3 id=&quot;1-创建一个-go-应用&quot;&gt;1. 创建一个 Go 应用&lt;/h3&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Go&quot;&gt;Go&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-go prism-line-numbers&quot; data-language=&quot;Go&quot;&gt;// main.go
package main

import (
    &amp;quot;fmt&amp;quot;
    &amp;quot;net/http&amp;quot;
)

func main() {
    http.HandleFunc(&amp;quot;/&amp;quot;, func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, &amp;quot;Hello from up!&amp;quot;)
    })
    http.ListenAndServe(&amp;quot;:3000&amp;quot;, nil)
}&lt;/pre&gt;

&lt;h3 id=&quot;2-部署&quot;&gt;2. 部署&lt;/h3&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;up&lt;/pre&gt;

&lt;p&gt;输出类似：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Plain text&quot;&gt;Plain text&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-plaintext prism-line-numbers&quot; data-language=&quot;Plain text&quot;&gt;   build: 0.8s
  deploy: 12.3s
     url: https://xyz123.execute-api.us-east-1.amazonaws.com/production/&lt;/pre&gt;

&lt;h3 id=&quot;3-查看日志&quot;&gt;3. 查看日志&lt;/h3&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;up logs -f&lt;/pre&gt;

&lt;h3 id=&quot;4-绑定自定义域名&quot;&gt;4. 绑定自定义域名&lt;/h3&gt;

&lt;p&gt;在 &lt;code&gt;up.json&lt;/code&gt; 中配置：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;JSON&quot;&gt;JSON&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-json prism-line-numbers&quot; data-language=&quot;JSON&quot;&gt;{
  &amp;quot;name&amp;quot;: &amp;quot;my-app&amp;quot;,
  &amp;quot;profile&amp;quot;: &amp;quot;default&amp;quot;,
  &amp;quot;regions&amp;quot;: [&amp;quot;us-east-1&amp;quot;],
  &amp;quot;stages&amp;quot;: {
    &amp;quot;production&amp;quot;: {
      &amp;quot;domain&amp;quot;: &amp;quot;api.example.com&amp;quot;
    }
  }
}&lt;/pre&gt;

&lt;p&gt;再次运行 &lt;code&gt;up deploy production&lt;/code&gt;，&lt;code&gt;up&lt;/code&gt; 会自动通过 ACM 申请并绑定证书，同时创建 Route53 记录（若域名也托管在 Route53）。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;六-up-json-配置文件一览&quot;&gt;六、&lt;code&gt;up.json&lt;/code&gt; 配置文件一览&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;up.json&lt;/code&gt; 是 &lt;code&gt;up&lt;/code&gt; 的可选配置文件，几乎所有能力都可以通过它声明：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;JSON&quot;&gt;JSON&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-json prism-line-numbers&quot; data-language=&quot;JSON&quot;&gt;{
  &amp;quot;name&amp;quot;: &amp;quot;my-app&amp;quot;,
  &amp;quot;profile&amp;quot;: &amp;quot;default&amp;quot;,
  &amp;quot;regions&amp;quot;: [&amp;quot;us-east-1&amp;quot;],
  &amp;quot;memory&amp;quot;: 512,
  &amp;quot;timeout&amp;quot;: 10,
  &amp;quot;runtime&amp;quot;: &amp;quot;go1.x&amp;quot;,
  &amp;quot;environment&amp;quot;: {
    &amp;quot;FOO&amp;quot;: &amp;quot;bar&amp;quot;
  },
  &amp;quot;cors&amp;quot;: {
    &amp;quot;allow_origins&amp;quot;: [&amp;quot;*&amp;quot;],
    &amp;quot;allow_methods&amp;quot;: [&amp;quot;GET&amp;quot;, &amp;quot;POST&amp;quot;]
  },
  &amp;quot;headers&amp;quot;: {
    &amp;quot;Cache-Control&amp;quot;: &amp;quot;max-age=3600&amp;quot;
  },
  &amp;quot;redirects&amp;quot;: {
    &amp;quot;/old&amp;quot;: { &amp;quot;location&amp;quot;: &amp;quot;/new&amp;quot;, &amp;quot;status&amp;quot;: 301 }
  },
  &amp;quot;static&amp;quot;: {
    &amp;quot;dir&amp;quot;: &amp;quot;public&amp;quot;,
    &amp;quot;prefix&amp;quot;: &amp;quot;/assets&amp;quot;
  }
}&lt;/pre&gt;

&lt;p&gt;多环境：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;JSON&quot;&gt;JSON&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-json prism-line-numbers&quot; data-language=&quot;JSON&quot;&gt;{
  &amp;quot;stages&amp;quot;: {
    &amp;quot;staging&amp;quot;:    { &amp;quot;domain&amp;quot;: &amp;quot;staging.example.com&amp;quot; },
    &amp;quot;production&amp;quot;: { &amp;quot;domain&amp;quot;: &amp;quot;api.example.com&amp;quot;, &amp;quot;memory&amp;quot;: 1024 }
  }
}&lt;/pre&gt;

&lt;hr&gt;

&lt;h2 id=&quot;七-典型命令速查&quot;&gt;七、典型命令速查&lt;/h2&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;up                          # 部署到 staging（默认）
up deploy production        # 部署到生产环境
up url                      # 查看当前环境 URL
up logs -f                  # 实时日志
up metrics                  # 调用指标
up stack plan               # 预览 Stack 变更
up stack deploy             # 部署 Stack
up start                    # 本地模拟运行
up config                   # 查看解析后的配置
up rollback                 # 回滚到上一版本
up delete                   # 删除应用&lt;/pre&gt;

&lt;hr&gt;

&lt;h2 id=&quot;八-架构理解&quot;&gt;八、架构理解&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;up&lt;/code&gt; 在底层封装了三类 AWS 资源：&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Lambda 函数&lt;/strong&gt;：承载你的应用（Go 支持通过 &lt;code&gt;apex/go&lt;/code&gt; 适配层把 HTTP Server 包装成 Lambda handler）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;API Gateway&lt;/strong&gt;：作为公网入口，将 HTTP 请求转发给 Lambda。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;ACM + Route53&lt;/strong&gt;（可选）：自动为自定义域名签发证书并配置 DNS。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;对于 Go 应用，&lt;code&gt;up&lt;/code&gt; 会利用 Apex 自己维护的 &lt;code&gt;aws-lambda-go&lt;/code&gt; 适配器，把你的 &lt;code&gt;http.Handler&lt;/code&gt; 嵌入到 Lambda event 处理逻辑中，从而让你&lt;strong&gt;可以完全用标准的 net/http 编写应用&lt;/strong&gt;，不需要关心 Lambda 的 event 结构。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;九-优势与局限&quot;&gt;九、优势与局限&lt;/h2&gt;

&lt;h3 id=&quot;优势&quot;&gt;优势&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;开箱即用&lt;/strong&gt;：零配置即可让一个普通 Web 应用跑在 Serverless 上。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;开发者体验极佳&lt;/strong&gt;：日志、域名、CORS、回滚全部一条命令搞定。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;多语言统一&lt;/strong&gt;：同一套 CLI 适配 Node / Go / Python / Java。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Stack 组合能力&lt;/strong&gt;：能声明式编排多个 Lambda 服务，共享一个 API Gateway。&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;局限&quot;&gt;局限&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;仅支持 AWS&lt;/strong&gt;：无法用于 GCP、Azure 等平台。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;项目已归档&lt;/strong&gt;：AWS 本身 API 变化较快（尤其 API Gateway v2、Lambda Runtime API），此工具不持续更新会导致兼容性问题。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;定位尴尬&lt;/strong&gt;：后来出现了 &lt;strong&gt;AWS SAM&lt;/strong&gt;、&lt;strong&gt;Serverless Framework&lt;/strong&gt;、&lt;strong&gt;SST&lt;/strong&gt;、&lt;strong&gt;Chalice&lt;/strong&gt; 等更活跃的方案，且 AWS 官方推出 Lambda Function URLs、HTTP API 等能力，&lt;code&gt;up&lt;/code&gt; 的差异化被稀释。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;生产调试能力有限&lt;/strong&gt;：对于复杂微服务、灰度发布、Observability 场景力不从心。&lt;/li&gt;
&lt;/ul&gt;

&lt;hr&gt;

&lt;h2 id=&quot;十-延伸思考-up-给我们的启示&quot;&gt;十、延伸思考：&lt;code&gt;up&lt;/code&gt; 给我们的启示&lt;/h2&gt;

&lt;p&gt;虽然 &lt;code&gt;up&lt;/code&gt; 已归档，但项目本身仍是一个极佳的学习样本，尤其在：&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;CLI 设计&lt;/strong&gt;——如何用很短的命令覆盖开发、部署、观测全流程；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;配置解析&lt;/strong&gt;——&lt;code&gt;up.json&lt;/code&gt; 的零配置 + 多环境覆盖模型至今仍是主流方案；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;AWS SDK 封装&lt;/strong&gt;——Lambda + API Gateway 编排的工程化实践；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Serverless 抽象层&lt;/strong&gt;——如何做到“让用户只写业务代码”。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;如果你打算做类似工具或研究 Serverless 工程设计，仓库里的 &lt;code&gt;internal/api&lt;/code&gt;、&lt;code&gt;internal/aws&lt;/code&gt;、&lt;code&gt;internal/config&lt;/code&gt; 几个包非常值得一读。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;总结&quot;&gt;总结&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;up&lt;/code&gt; 用最简洁的命令行接口，把 AWS Serverless 的复杂度隐藏起来，是 2017 年前后 Golang 生态中“开发者体验优先”的典范项目。尽管今天已不再维护，但它的设计理念对今天的 &lt;strong&gt;SST&lt;/strong&gt;、&lt;strong&gt;Amplify&lt;/strong&gt;、&lt;strong&gt;Flightcontrol&lt;/strong&gt; 等工具产生了直接影响。对于每一个希望深入 Serverless 工程化的开发者来说，&lt;code&gt;up&lt;/code&gt; 依然是一座值得参观的历史地标。&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;⚠️ 提示：由于项目已归档，新项目请优先评估 &lt;strong&gt;AWS SAM&lt;/strong&gt;、&lt;strong&gt;Serverless Framework&lt;/strong&gt; 或 &lt;strong&gt;SST&lt;/strong&gt;。&lt;code&gt;up&lt;/code&gt; 适合用来学习与理解 Serverless 的底层抽象。&lt;/p&gt;
&lt;/blockquote&gt;
</description><pubDate>Sun, 22 Nov 2026 09:02:17 +0800</pubDate></item><item><title>Pascal-DelphiRemotePushSender 项目介绍</title><link>https://zelig.cn/delphi/1525.html</link><description>&lt;p&gt;&lt;img src=&quot;/zb_users/upload/2026/11/20261112184014c8e026dcb1ca.png&quot; alt=&quot;Pascal-DelphiRemotePushSender 项目介绍&quot;&gt;&lt;/p&gt;&lt;h1 id=&quot;delphiremotepushsender-项目介绍&quot;&gt;DelphiRemotePushSender 项目介绍&lt;/h1&gt;

&lt;h2 id=&quot;一-项目概述&quot;&gt;一、项目概述&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;DelphiRemotePushSender&lt;/strong&gt; 是由 Grijjy 团队开发的一个开源 Delphi 项目，用于向移动设备发送&lt;strong&gt;远程推送通知（Remote Push Notifications）&lt;/strong&gt;。它同时支持 &lt;strong&gt;iOS（APNs）&lt;/strong&gt; 和 &lt;strong&gt;Android（FCM）&lt;/strong&gt; 两大主流推送平台，让 Delphi 开发者能够直接在服务端（或桌面端工具）中构造并发送推送消息，而无需依赖第三方推送服务网关。&lt;/p&gt;

&lt;p&gt;项目地址：&lt;a href=&quot;https://github.com/grijjy/DelphiRemotePushSender&quot;&gt;https://github.com/grijjy/DelphiRemotePushSender&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;对于需要自建后端推送能力、或者想在 Delphi 生态内完成&amp;rdquo;端到端&amp;rdquo;推送链路的团队来说，这是一个非常实用的基础组件。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;二-为什么需要它&quot;&gt;二、为什么需要它&lt;/h2&gt;

&lt;p&gt;在移动应用开发中，推送通知几乎是标配功能。但传统的做法往往是：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;使用第三方聚合推送服务（如极光、个推、OneSignal 等），引入外部依赖和费用；&lt;/li&gt;
&lt;li&gt;或者用其他语言（Node.js、Java、Python）单独写一个推送微服务，与 Delphi 后端割裂。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;DelphiRemotePushSender&lt;/strong&gt; 的价值在于：&lt;strong&gt;用纯 Delphi 直接对接 APNs 和 FCM 的官方 HTTP/2 接口&lt;/strong&gt;，把推送能力原生地集成进 Delphi 后端体系。这样一来：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;技术栈统一，维护成本低；&lt;/li&gt;
&lt;li&gt;可以精细控制推送内容、设备令牌管理、错误处理；&lt;/li&gt;
&lt;li&gt;不与任何第三方服务商绑定。&lt;/li&gt;
&lt;/ul&gt;

&lt;hr&gt;

&lt;h2 id=&quot;三-核心特性&quot;&gt;三、核心特性&lt;/h2&gt;

&lt;h3 id=&quot;1-双平台支持&quot;&gt;1. 双平台支持&lt;/h3&gt;

&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;平台&lt;/th&gt;
&lt;th&gt;推送服务&lt;/th&gt;
&lt;th&gt;底层协议&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;

&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;iOS / macOS&lt;/td&gt;
&lt;td&gt;APNs（Apple Push Notification service）&lt;/td&gt;
&lt;td&gt;基于 HTTP/2 的 Provider API&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;Android&lt;/td&gt;
&lt;td&gt;FCM（Firebase Cloud Messaging）&lt;/td&gt;
&lt;td&gt;HTTP v1 API&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;两者都基于现代的 HTTP/2 + JSON 载荷方式，取代了老旧的二进制协议和 legacy FCM 接口。&lt;/p&gt;

&lt;h3 id=&quot;2-基于-http-2-的现代实现&quot;&gt;2. 基于 HTTP/2 的现代实现&lt;/h3&gt;

&lt;p&gt;APNs 和 FCM 都要求通过 HTTP/2 与服务器通信，涉及 TLS、长连接、HPACK 头压缩等细节。项目封装了这些底层复杂度（底层可依赖 Grijjy 自家的 &lt;code&gt;DelphiHttp2&lt;/code&gt; 等库），开发者只需关注&amp;rdquo;发什么&amp;rdquo;，而不用操心&amp;rdquo;怎么连&amp;rdquo;。&lt;/p&gt;

&lt;h3 id=&quot;3-认证方式&quot;&gt;3. 认证方式&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;APNs&lt;/strong&gt;：支持基于 &lt;strong&gt;JWT Token&lt;/strong&gt;（.p8 私钥）的认证方式，这是 Apple 推荐的现代做法，一个 Token 可覆盖多个 App、长期有效，无需频繁更换证书。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;FCM&lt;/strong&gt;：支持基于 &lt;strong&gt;Service Account（OAuth 2.0）&lt;/strong&gt; 的认证，符合 FCM HTTP v1 API 的规范。&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;4-简化的-api-设计&quot;&gt;4. 简化的 API 设计&lt;/h3&gt;

&lt;p&gt;典型使用流程大致为：&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;配置认证信息（APNs 的 Team ID、Key ID、.p8 文件；FCM 的服务账号 JSON）；&lt;/li&gt;
&lt;li&gt;准备目标设备的 Device Token；&lt;/li&gt;
&lt;li&gt;构造通知载荷（标题、正文、角标、自定义数据等 JSON 结构）；&lt;/li&gt;
&lt;li&gt;调用发送方法，处理返回结果与错误。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;项目通过面向对象的方式把这些步骤封装成清晰的类和方法，减少了手工拼接 HTTP 请求和 JSON 的易错工作。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;四-适用场景&quot;&gt;四、适用场景&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Delphi 自建后端&lt;/strong&gt;需要向 App 用户推送消息（订单提醒、聊天消息、系统公告等）；&lt;/li&gt;
&lt;li&gt;需要在 Delphi 桌面程序里做&lt;strong&gt;推送测试工具&lt;/strong&gt;，快速验证设备令牌和载荷是否生效；&lt;/li&gt;
&lt;li&gt;想摆脱第三方推送服务，构建&lt;strong&gt;自主可控&lt;/strong&gt;的推送管道；&lt;/li&gt;
&lt;li&gt;学习 APNs / FCM 官方接口在 Delphi 中如何落地实现。&lt;/li&gt;
&lt;/ul&gt;

&lt;hr&gt;

&lt;h2 id=&quot;五-使用前的准备&quot;&gt;五、使用前的准备&lt;/h2&gt;

&lt;p&gt;要真正跑通推送，你需要先在平台侧完成配置：&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;iOS（APNs）&lt;/strong&gt;
- 在 Apple Developer 后台创建 &lt;strong&gt;APNs Auth Key（.p8）&lt;/strong&gt;，记录 Team ID 和 Key ID；
- 应用端需具备推送权限并拿到 APNs Device Token。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Android（FCM）&lt;/strong&gt;
- 在 Firebase 控制台创建项目、添加应用；
- 下载 &lt;strong&gt;Service Account 私钥 JSON&lt;/strong&gt;；
- 应用端集成 Firebase SDK，获取 FCM Registration Token。&lt;/p&gt;

&lt;p&gt;准备好这些凭据后，才能在 Delphi 端配置并发送。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;六-技术要点与注意事项&quot;&gt;六、技术要点与注意事项&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;必须使用 HTTP/2&lt;/strong&gt;：APNs 和 FCM 新接口都只接受 HTTP/2 连接，项目已在底层处理，但运行环境需支持 TLS 1.2+。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;令牌管理&lt;/strong&gt;：APNs Token 有有效期，需按 Apple 要求定期刷新（不要生成过于频繁，也不要过期）；FCM 的 OAuth Token 也需处理过期刷新。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;错误反馈机制&lt;/strong&gt;：两平台都会返回 HTTP 状态码和结构化错误体（如 APNs 的 &lt;code&gt;reason&lt;/code&gt; 字段、FCM 的错误码），生产环境要据此做重试、清理失效令牌等处理。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;载荷大小限制&lt;/strong&gt;：APNs 载荷通常限制在 4KB（VoIP 等特殊类型另有规定），FCM 也有相应限制，超限会被拒收。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;与客户端配合&lt;/strong&gt;：服务端发送只是链路一半，客户端还需正确注册、接收并处理通知，才能真正形成闭环。&lt;/li&gt;
&lt;/ol&gt;

&lt;hr&gt;

&lt;h2 id=&quot;七-总结&quot;&gt;七、总结&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;DelphiRemotePushSender&lt;/strong&gt; 填补了 Delphi 生态在&amp;rdquo;自建移动推送后端&amp;rdquo;方面的一个空白。它以现代 HTTP/2 接口为基础，原生支持 APNs 与 FCM，帮助 Delphi 开发者在熟悉的语言与工具链内完成从设备令牌到推送载荷的完整发送流程。&lt;/p&gt;

&lt;p&gt;如果你的项目是用 Delphi 写后端、并且需要向 iOS/Android 用户推送消息，这个库值得纳入技术选型评估。建议先在其 GitHub 仓库阅读示例代码与 README，结合官方 APNs / FCM 文档理解认证与载荷结构，再动手接入。&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;仓库地址：&lt;a href=&quot;https://github.com/grijjy/DelphiRemotePushSender&quot;&gt;https://github.com/grijjy/DelphiRemotePushSender&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;提示：请以仓库最新提交文档为准，平台接口与库的 API 都可能随版本演进发生变化。&lt;/p&gt;
&lt;/blockquote&gt;
</description><pubDate>Sun, 22 Nov 2026 02:23:17 +0800</pubDate></item><item><title>Golang-Go 版 HttpRunner 介绍</title><link>https://zelig.cn/golang/1524.html</link><description>&lt;p&gt;&lt;img src=&quot;/zb_users/upload/2026/11/202611121859540da90913856f.png&quot; alt=&quot;Golang-Go 版 HttpRunner 介绍&quot;&gt;&lt;/p&gt;&lt;h1 id=&quot;go-版-httprunner-介绍&quot;&gt;Go 版 HttpRunner 介绍&lt;/h1&gt;

&lt;h2 id=&quot;背景&quot;&gt;背景&lt;/h2&gt;

&lt;p&gt;HttpRunner 最早是以 Python 实现的接口自动化测试框架，在社区里积累了大量用户。随着 Go 语言在后端和云原生领域的普及，HttpRunner 官方推出了 &lt;strong&gt;Go 版本（v4+）&lt;/strong&gt;，用 Go 重写了核心引擎，保留了 YAML/JSON 驱动的测试用例风格，同时带来了更小的体积、更高的并发能力和更好的部署体验。&lt;/p&gt;

&lt;p&gt;项目地址：&lt;a href=&quot;https://github.com/httprunner/httprunner&quot;&gt;https://github.com/httprunner/httprunner&lt;/a&gt;&lt;/p&gt;

&lt;h2 id=&quot;它是什么&quot;&gt;它是什么&lt;/h2&gt;

&lt;p&gt;Go 版 HttpRunner 是一个&lt;strong&gt;开源、协议无关的接口测试框架&lt;/strong&gt;，核心特点：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;用例即配置&lt;/strong&gt;：用 YAML/JSON 描述 HTTP(S)、gRPC 等接口的测试步骤、断言、变量、参数化，无需写代码即可完成大部分测试。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;CLI 优先&lt;/strong&gt;：一个 &lt;code&gt;hrp&lt;/code&gt; 二进制即可完成录制、转换、运行、生成报告、执行性能测试等常用操作。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;支持多协议&lt;/strong&gt;：HTTP(S)、HTTP/2、gRPC、TCP 等（借助插件和扩展）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;支持性能测试&lt;/strong&gt;：内置基于 &lt;code&gt;boomer&lt;/code&gt; 的压测能力（与 Locust 生态兼容）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;工程化友好&lt;/strong&gt;：单文件可执行，适合接入 CI/CD 与容器化运行。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;安装与快速上手&quot;&gt;安装与快速上手&lt;/h2&gt;

&lt;h3 id=&quot;安装&quot;&gt;安装&lt;/h3&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;# macOS / Linux
bash -c &amp;quot;$(curl -ksfL https://raw.githubusercontent.com/httprunner/install/master/install.sh)&amp;quot;
# 或使用 go install
go install github.com/httprunner/httprunner/v4@latest&lt;/pre&gt;

&lt;p&gt;安装后验证：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;hrp -v&lt;/pre&gt;

&lt;h3 id=&quot;一个最小-http-用例-yaml&quot;&gt;一个最小 HTTP 用例（YAML）&lt;/h3&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;YAML&quot;&gt;YAML&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-yaml prism-line-numbers&quot; data-language=&quot;YAML&quot;&gt;config:
  name: &amp;quot;demo api test&amp;quot;
  base_url: &amp;quot;https://httpbin.org&amp;quot;
  variables:
    username: &amp;quot;httprunner&amp;quot;

teststeps:
  - name: &amp;quot;get with query&amp;quot;
    request:
      method: GET
      url: &amp;quot;/get&amp;quot;
      params:
        name: $username
    validate:
      - check: status_code
        assert: equals
        expected: 200
      - check: body.args.name
        assert: equals
        expected: &amp;quot;httprunner&amp;quot;&lt;/pre&gt;

&lt;p&gt;运行：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;hrp run demo.yaml&lt;/pre&gt;

&lt;p&gt;用参数化做数据驱动：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;YAML&quot;&gt;YAML&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-yaml prism-line-numbers&quot; data-language=&quot;YAML&quot;&gt;config:
  name: &amp;quot;param demo&amp;quot;
  base_url: &amp;quot;https://httpbin.org&amp;quot;
  parameters:
    user: [alice, bob, carol]
teststeps:
  - name: &amp;quot;get /get&amp;quot;
    request:
      method: GET
      url: /get
      params:
        user: $user
    validate:
      - check: body.args.user
        assert: equals
        expected: $user&lt;/pre&gt;

&lt;h3 id=&quot;性能测试&quot;&gt;性能测试&lt;/h3&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;hrp boom demo.yaml --spawn-count 50 --spawn-rate 5 --run-time 30s&lt;/pre&gt;

&lt;p&gt;得到与 Locust 类似的结果报表，可无缝接入现有的压测体系。&lt;/p&gt;

&lt;h3 id=&quot;录制与转换&quot;&gt;录制与转换&lt;/h3&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;# 录制 HTTP 流量生成用例
hrp record --save-tests ./recorded
# 将 HAR 转为测试用例
hrp convert --from-har x.har --to-yaml&lt;/pre&gt;

&lt;h2 id=&quot;典型使用场景&quot;&gt;典型使用场景&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;接口回归测试&lt;/strong&gt;：YAML 管理用例，接入 CI，运行 &lt;code&gt;hrp run cases/&lt;/code&gt; 即可。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;数据驱动测试&lt;/strong&gt;：&lt;code&gt;parameters&lt;/code&gt; 支持笛卡尔积、CSV 引用等，方便做多组合验证。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;性能压测&lt;/strong&gt;：用同一份用例做功能与性能双用。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;混沌/混合协议测试&lt;/strong&gt;：通过插件机制扩展协议（例如 WebSocket、TCP、DNS 等）。&lt;/li&gt;
&lt;/ol&gt;

&lt;h2 id=&quot;与-python-版本的关系&quot;&gt;与 Python 版本的关系&lt;/h2&gt;

&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;维度&lt;/th&gt;
&lt;th&gt;Python 版&lt;/th&gt;
&lt;th&gt;Go 版（v4+）&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;

&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;运行时&lt;/td&gt;
&lt;td&gt;需要 Python 环境&lt;/td&gt;
&lt;td&gt;单二进制&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;性能&lt;/td&gt;
&lt;td&gt;中等&lt;/td&gt;
&lt;td&gt;更高&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;生态/插件&lt;/td&gt;
&lt;td&gt;最丰富&lt;/td&gt;
&lt;td&gt;逐步完善，支持插件&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;用例 YAML 兼容&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;td&gt;大体兼容，部分字段有所调整&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;如果你是存量 Python 用户，迁移时主要注意 &lt;code&gt;teststeps&lt;/code&gt; 字段结构（v4 使用 &lt;code&gt;request&lt;/code&gt; 而非 &lt;code&gt;api&lt;/code&gt;/&lt;code&gt;method&lt;/code&gt; 直接平铺）以及断言写法（&lt;code&gt;validate&lt;/code&gt; 的 &lt;code&gt;check/assert/expected&lt;/code&gt; 结构）。&lt;/p&gt;

&lt;h2 id=&quot;工程实践建议&quot;&gt;工程实践建议&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;目录规范&lt;/strong&gt;：&lt;code&gt;config/&lt;/code&gt; 放公共变量与 host，&lt;code&gt;testcases/&lt;/code&gt; 放单接口用例，&lt;code&gt;testsuites/&lt;/code&gt; 组合用例。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;环境隔离&lt;/strong&gt;：利用 &lt;code&gt;--venv&lt;/code&gt;/ENV 变量或 config 中的 &lt;code&gt;base_url&lt;/code&gt; 覆盖，避免硬编码 host。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;报告产出&lt;/strong&gt;：&lt;code&gt;hrp run --gen-html-report&lt;/code&gt; 生成 HTML 报告；配合 &lt;code&gt;--save-tests&lt;/code&gt; 留存运行产物用于排障。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;CI 集成&lt;/strong&gt;：以容器方式运行 &lt;code&gt;httprunner/httprunner:latest&lt;/code&gt;，缩短环境准备时间。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;断言分层&lt;/strong&gt;：优先断言 &lt;code&gt;status_code&lt;/code&gt; 和关键字段，避免过度耦合响应结构。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;总结&quot;&gt;总结&lt;/h2&gt;

&lt;p&gt;Go 版 HttpRunner 把「YAML 描述用例 + 单二进制执行」的组合做得很扎实：既能满足日常接口自动化，也覆盖了压测与多协议扩展，落地成本低。对需要把测试能力嵌入流水线、又不想维护 Python 环境的团队来说，它是一个很值得上手的方案。&lt;/p&gt;
</description><pubDate>Sat, 21 Nov 2026 16:52:17 +0800</pubDate></item><item><title>Pascal-DelphiScalableClientSockets 介绍</title><link>https://zelig.cn/delphi/1523.html</link><description>&lt;p&gt;&lt;img src=&quot;/zb_users/upload/2026/11/2026111218400470c4f910725a.svg&quot; alt=&quot;Pascal-DelphiScalableClientSockets 介绍&quot;&gt;&lt;/p&gt;&lt;h1 id=&quot;delphiscalableclientsockets-介绍&quot;&gt;DelphiScalableClientSockets 介绍&lt;/h1&gt;

&lt;h2 id=&quot;项目概述&quot;&gt;项目概述&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;DelphiScalableClientSockets&lt;/strong&gt; 是由 Grijjy 团队开发的一个开源 Pascal/Delphi 网络库，专为构建&lt;strong&gt;高并发、可扩展的客户端 Socket 连接&lt;/strong&gt;而设计。项目地址为：&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;a href=&quot;https://github.com/grijjy/DelphiScalableClientSockets&quot;&gt;https://github.com/grijjy/DelphiScalableClientSockets&lt;/a&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;它的核心目标是解决传统 Delphi 客户端 Socket 编程中一个非常棘手的问题：&lt;strong&gt;如何在单个进程内管理成千上万个并发客户端连接，而不会因为线程数爆炸而导致性能崩溃&lt;/strong&gt;。&lt;/p&gt;

&lt;h2 id=&quot;为什么需要这个库&quot;&gt;为什么需要这个库？&lt;/h2&gt;

&lt;p&gt;传统的 Delphi 客户端 Socket 实现通常会为每个连接分配一个线程（thread-per-connection 模型）。当连接数达到几百个时，线程上下文切换、内存占用和调度开销就会成为瓶颈。当连接数上升到数千甚至数万时，这种模型基本无法工作。&lt;/p&gt;

&lt;p&gt;DelphiScalableClientSockets 采用&lt;strong&gt;事件驱动 + I/O 多路复用&lt;/strong&gt;的架构，参考了服务端高并发编程的思路，把&amp;rdquo;每个连接一个线程&amp;rdquo;改造成&amp;rdquo;少量线程驱动海量连接&amp;rdquo;，从而在单进程内轻松支撑大规模并发客户端。&lt;/p&gt;

&lt;h2 id=&quot;核心特性&quot;&gt;核心特性&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;跨平台支持&lt;/strong&gt;：同时支持 Windows、macOS、Linux、iOS 和 Android，底层针对不同平台使用相应的异步 I/O 机制。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;可扩展的并发模型&lt;/strong&gt;：基于 I/O 完成端口（Windows）和 epoll/kqueue 等机制，避免线程爆炸。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;简洁的 API&lt;/strong&gt;：采用事件回调风格，通过 &lt;code&gt;OnConnected&lt;/code&gt;、&lt;code&gt;OnDisconnected&lt;/code&gt;、&lt;code&gt;OnRecv&lt;/code&gt; 等事件处理连接生命周期，开发者无需关心底层多路复用细节。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;支持大规模连接&lt;/strong&gt;：设计目标就是&amp;rdquo;Scalable&amp;rdquo;，可管理数千甚至上万个客户端连接。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;纯 Pascal 实现&lt;/strong&gt;：无外部依赖，直接编译进项目即可使用。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;基本使用范式&quot;&gt;基本使用范式&lt;/h2&gt;

&lt;p&gt;使用该库的典型流程大致如下：&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;创建客户端对象（例如 &lt;code&gt;TgoClientConnection&lt;/code&gt;）。&lt;/li&gt;
&lt;li&gt;设置事件回调处理连接、断开、接收数据。&lt;/li&gt;
&lt;li&gt;调用 &lt;code&gt;Connect&lt;/code&gt; 连接到目标服务器。&lt;/li&gt;
&lt;li&gt;连接成功后通过 &lt;code&gt;Send&lt;/code&gt; 发送数据，在 &lt;code&gt;OnRecv&lt;/code&gt; 中处理接收到的数据。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;伪代码示意：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Pascal&quot;&gt;Pascal&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-pascal prism-line-numbers&quot; data-language=&quot;Pascal&quot;&gt;var
  Client: IgoClientConnection;
begin
  Client := TgoClientConnection.Create;
  Client.OnConnected    := HandleConnected;
  Client.OnDisconnected := HandleDisconnected;
  Client.OnRecv         := HandleRecv;
  Client.Connect(&#039;127.0.0.1&#039;, 8080);
end;

procedure HandleConnected(const Sender: IgoClientConnection);
begin
  Sender.Send(&#039;Hello Server&#039;);
end;

procedure HandleRecv(const Sender: IgoClientConnection;
  const AData: Pointer; const ASize: Integer);
begin
  // 处理接收到的数据
end;&lt;/pre&gt;

&lt;p&gt;通过这种接口抽象，调用方专注于业务逻辑，底层的并发与异步调度都由库负责。&lt;/p&gt;

&lt;h2 id=&quot;适用场景&quot;&gt;适用场景&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;IM / 聊天应用&lt;/strong&gt;：单个客户端需要同时维持多条长连接（如多个会话通道）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;金融行情推送客户端&lt;/strong&gt;：需要同时订阅大量数据源或大量服务器连接。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;物联网网关客户端&lt;/strong&gt;：一台客户端设备需管理海量下游连接。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;压力测试工具 / 模拟客户端&lt;/strong&gt;：需要在一台机器上模拟成千上万个并发客户端。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;需要跨平台一致网络行为的桌面/移动应用&lt;/strong&gt;。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;技术亮点&quot;&gt;技术亮点&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;接口化设计&lt;/strong&gt;：返回接口（interface）类型，便于生命周期管理与解耦。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;内存管理友好&lt;/strong&gt;：接收回调以指针+长度形式传递，减少数据拷贝，适合高性能场景。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;与 Grijjy 生态协同&lt;/strong&gt;：作者 Grijjy 团队在 Delphi 高性能网络、异步、加密领域有丰富开源积累（如 GrijjyFoundation 等），该项目可与这些库良好配合。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;注意事项&quot;&gt;注意事项&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;该库主要面向&lt;strong&gt;客户端侧&lt;/strong&gt;的高并发场景，服务端高并发应参考 Grijjy 的服务器方案（如相关的 ScalableServerSockets 项目）。&lt;/li&gt;
&lt;li&gt;使用前建议仔细阅读仓库中的 README 与示例代码，理解回调线程模型（回调在库的内部线程上触发，UI 更新需自行同步到主线程）。&lt;/li&gt;
&lt;li&gt;项目仍在演进，需关注其分支与兼容的 Delphi 版本要求。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;总结&quot;&gt;总结&lt;/h2&gt;

&lt;p&gt;DelphiScalableClientSockets 填补了 Delphi 生态中&amp;rdquo;&lt;strong&gt;单进程海量客户端连接&lt;/strong&gt;&amp;ldquo;这一细分领域的空白。它把服务端级别的 I/O 多路复用思想带入客户端编程，让 Pascal/Delphi 开发者无需深入底层系统 API，也能构建出可扩展、跨平台的高并发网络客户端。对于需要管理大量并发连接的应用（压测工具、行情客户端、网关等），它是一个值得认真评估的选择。&lt;/p&gt;

&lt;p&gt;如果你正在用 Delphi 写涉及大量 Socket 连接的客户端程序，又不想被&amp;rdquo;线程爆炸&amp;rdquo;困扰，这个库非常值得一试。&lt;/p&gt;
</description><pubDate>Sat, 21 Nov 2026 13:24:17 +0800</pubDate></item><item><title>深入解析 docker-archive/docker-ce：Golang 视角下的 Docker CE 源码剖析</title><link>https://zelig.cn/golang/1522.html</link><description>&lt;p&gt;&lt;img src=&quot;/zb_users/upload/2026/11/2026111218594675c9dd631873.png&quot; alt=&quot;深入解析 docker-archive/docker-ce：Golang 视角下的 Docker CE 源码剖析&quot;&gt;&lt;/p&gt;&lt;h1 id=&quot;深入解析-docker-archive-docker-ce-golang-视角下的-docker-ce-源码剖析&quot;&gt;深入解析 docker-archive/docker-ce：Golang 视角下的 Docker CE 源码剖析&lt;/h1&gt;

&lt;blockquote&gt;
&lt;p&gt;项目地址：&lt;a href=&quot;https://github.com/docker-archive/docker-ce&quot;&gt;https://github.com/docker-archive/docker-ce&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;这是一个 Go 开发者阅读容器引擎源码的绝佳入口，也是理解&amp;rdquo;一个工业级 Go 项目如何组织&amp;rdquo;的活教材。&lt;/p&gt;
&lt;/blockquote&gt;

&lt;hr&gt;

&lt;h2 id=&quot;一-这是什么项目&quot;&gt;一、这是什么项目？&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;docker-archive/docker-ce&lt;/code&gt; 是 &lt;strong&gt;Docker Community Edition（Docker CE）的官方源码归档仓库&lt;/strong&gt;。在 2017 年，Docker 公司将 Docker 引擎的代码从原来的 &lt;code&gt;docker/docker&lt;/code&gt; 仓库迁移到这里，用于组织 &lt;strong&gt;Docker CE 的打包、构建与发布流程&lt;/strong&gt;，后来在 2019 年前后，Docker 的组件进一步拆分到 &lt;code&gt;moby/moby&lt;/code&gt; 等独立仓库中，这个仓库便被归档（archive），进入了只读状态。&lt;/p&gt;

&lt;p&gt;需要先厘清一个常见的误解：&lt;/p&gt;

&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;仓库&lt;/th&gt;
&lt;th&gt;角色&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;

&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;docker-archive/docker-ce&lt;/code&gt;（本项目）&lt;/td&gt;
&lt;td&gt;Docker CE 的&lt;strong&gt;构建、打包、发布工程的仓库&lt;/strong&gt;，包含大量组件 Git 子模块（submodules）与构建脚本&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;code&gt;moby/moby&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Docker 引擎&lt;strong&gt;核心（daemon + client）&lt;/strong&gt;的真正源码&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;code&gt;opencontainers/runc&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;容器运行时（OCI runtime）&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;code&gt;containerd/containerd&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;容器生命周期管理&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;换句话说，&lt;code&gt;docker-ce&lt;/code&gt; 本身&lt;strong&gt;不是&lt;/strong&gt;引擎核心的一行行 Go 代码，而是一个&lt;strong&gt;&amp;ldquo;组装工厂&amp;rdquo;&lt;/strong&gt;：它把 containerd、runc、libnetwork、docker/cli、moby 等真正用 Go 写就的组件作为子模块聚合进来，然后拉取、编译、打包成你在 &lt;code&gt;apt&lt;/code&gt;/&lt;code&gt;yum&lt;/code&gt; 里安装的 &lt;code&gt;docker-ce&lt;/code&gt;。&lt;/p&gt;

&lt;p&gt;所以阅读这个仓库，你能学到的不是 &lt;code&gt;daemon&lt;/code&gt; 的网络栈实现细节，而是 &lt;strong&gt;一个大型 Go 项目族群如何做发布工程&lt;/strong&gt;。但正因为它引用了大量 Go 子模块，它依然非常适合作为你研究 Docker 源码栈的&amp;rdquo;导航地图&amp;rdquo;。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;二-仓库结构总览&quot;&gt;二、仓库结构总览&lt;/h2&gt;

&lt;p&gt;克隆下来之后，你会看到类似这样的目录布局：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Plain text&quot;&gt;Plain text&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-plaintext prism-line-numbers&quot; data-language=&quot;Plain text&quot;&gt;docker-ce/
├── components/           # 各个子组件的 build 工程（含打包、测试脚本）
│   ├── engine/           # moby 引擎组件
│   ├── cli/              # docker CLI (docker/cli)
│   ├── containerd/       # containerd
│   ├── runc/             # runc
│   ├── packaging/        # deb/rpm 打包定义
│   └── ...
├── deb/                  # Debian/Ubuntu 包构建入口
├── rpm/                  # RHEL/CentOS/Fedora 包构建入口
├── hack/                 # 各种辅助脚本（下载、校验、release 等）
├── MANIFEST                # 组件版本清单，核心文件！
├── VERSION                 # Docker CE 版本号
├── Makefile                # 顶层构建入口
└── .gitmodules             # 关键：所有 Go 组件子模块的地址与版本&lt;/pre&gt;

&lt;p&gt;对你（Golang 开发者）来说，&lt;strong&gt;两个文件至关重要&lt;/strong&gt;：&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;MANIFEST&lt;/code&gt;&lt;/strong&gt; —— 声明了每个组件（engine、cli、containerd……）在该次发布中对应的 &lt;strong&gt;提交 SHA / 分支&lt;/strong&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;.gitmodules&lt;/code&gt;&lt;/strong&gt; —— 定义每个组件从哪里拉取。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;它们一起构成了&amp;rdquo;&lt;strong&gt;可复现构建&lt;/strong&gt;&amp;ldquo;的基础：只要签出某个 tag，&lt;code&gt;MANIFEST&lt;/code&gt; 就能锁定所有组件的精确版本。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;三-构建流程-从-manifest-到-deb-包&quot;&gt;三、构建流程：从 MANIFEST 到 deb 包&lt;/h2&gt;

&lt;p&gt;以一个 &lt;code&gt;make deb&lt;/code&gt; 场景为例，顶层 &lt;code&gt;Makefile&lt;/code&gt; 会驱动 &lt;code&gt;hack/&lt;/code&gt; 下的脚本完成：&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;读取 &lt;code&gt;VERSION&lt;/code&gt; + &lt;code&gt;MANIFEST&lt;/code&gt;&lt;/strong&gt;，决定各组件版本；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;下载源码 tarball&lt;/strong&gt;（&lt;code&gt;hack/download.tgz&lt;/code&gt; 之类），或直接 clone 子模块；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;进入各组件目录执行 Go 构建&lt;/strong&gt;（通过 &lt;code&gt;components/engine&lt;/code&gt;、&lt;code&gt;components/cli&lt;/code&gt; 等 &lt;code&gt;Makefile&lt;/code&gt; 调用 &lt;code&gt;go build&lt;/code&gt;）；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;打 deb/rpm 包&lt;/strong&gt;：&lt;code&gt;deb/&lt;/code&gt; 与 &lt;code&gt;rpm/&lt;/code&gt; 下的模板把编译好的二进制（&lt;code&gt;dockerd&lt;/code&gt;、&lt;code&gt;docker&lt;/code&gt;、&lt;code&gt;containerd&lt;/code&gt;、&lt;code&gt;runc&lt;/code&gt;、&lt;code&gt;docker-proxy&lt;/code&gt;…）塞进包结构；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;签名 / 生成 repo 元数据&lt;/strong&gt;。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;对 Go 开发者有几点非常有参考价值：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;多组件版本协调&lt;/strong&gt;：一次发布涉及十几个 Go 仓库（moby、cli、libnetwork、swarmkit、containerd、runc、tini、docker-proxy……）。&lt;code&gt;MANIFEST&lt;/code&gt; 用一个&amp;rdquo;中央清单&amp;rdquo;锁定它们的 SHA，避免&amp;rdquo;组件漂移&amp;rdquo;。这是&lt;strong&gt;大型 monorepo / multi-repo 管理的经典范式&lt;/strong&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;构建与源码彻底解耦&lt;/strong&gt;：本仓库几乎不含业务 Go 代码，全部依赖外部组件。这种做法让&amp;rdquo;打包工程&amp;rdquo;可以独立演进而不至于污染引擎源码。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;可复现性（reproducible build）&lt;/strong&gt;：固定 SHA + 固定构建工具链 + 固定基础镜像，才能让&amp;rdquo;某版本 docker-ce&amp;rdquo;在任何机器上产出一致二进制。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;给你一个简化示意（实际脚本更复杂，但思路一致）：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;makefile&quot;&gt;makefile&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-makefile prism-line-numbers&quot; data-language=&quot;makefile&quot;&gt;# 顶层 Makefile 的简化示意
VERSION := $(shell cat VERSION)

.PHONY: checkout
checkout:
	@# 依据 .gitmodules 与 MANIFEST 拉取各组件
	git submodule update --init --recursive
	@# 若有 MANIFEST 中指定 SHA，则同步对齐
	./hack/sync-from-manifest.sh

.PHONY: build-engine
build-engine:
	$(MAKE) -C components/engine build VERSION=$(VERSION)

.PHONY: deb
deb: checkout build-engine
	@# 将二进制与配置塞入 deb 结构
	./hack/make.sh deb&lt;/pre&gt;

&lt;hr&gt;

&lt;h2 id=&quot;四-go-组件在这里扮演什么角色&quot;&gt;四、Go 组件在这里扮演什么角色？&lt;/h2&gt;

&lt;p&gt;虽然本仓库以打包为主，但它牵动的核心组件几乎都是 Go 写的。理清它们的职责，对你深入 Go 云原生栈很有帮助：&lt;/p&gt;

&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;组件&lt;/th&gt;
&lt;th&gt;语言&lt;/th&gt;
&lt;th&gt;职责&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;

&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;moby/moby&lt;/strong&gt; (&lt;code&gt;dockerd&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;Go&lt;/td&gt;
&lt;td&gt;Docker 守护进程，提供 Engine API&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;docker/cli&lt;/strong&gt; (&lt;code&gt;docker&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;Go&lt;/td&gt;
&lt;td&gt;命令行客户端&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;containerd&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Go&lt;/td&gt;
&lt;td&gt;容器运行时管理（镜像、容器生命周期）&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;runc&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Go&lt;/td&gt;
&lt;td&gt;OCI 运行时，真正调用 &lt;code&gt;clone&lt;/code&gt;/&lt;code&gt;pivot_root&lt;/code&gt; 等系统调用&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;libnetwork&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Go&lt;/td&gt;
&lt;td&gt;CNM 网络模型实现&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;swarmkit&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Go&lt;/td&gt;
&lt;td&gt;Swarm 编排&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;docker-proxy&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Go&lt;/td&gt;
&lt;td&gt;端口转发用户态实现&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;tini&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;C&lt;/td&gt;
&lt;td&gt;PID 1 init 进程&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;如果你曾在 &lt;code&gt;dockerd&lt;/code&gt; 里读过 &lt;code&gt;daemon/&lt;/code&gt; 目录，或在 containerd 里追过 &lt;code&gt;runtime/v2/task&lt;/code&gt;，你就能明白：&lt;code&gt;docker-ce&lt;/code&gt; 仓库的价值，就是把这条&lt;strong&gt;从 CLI → daemon → containerd → runc → 内核&lt;/strong&gt;的调用链完整地&amp;rdquo;封装成可发布的制品&amp;rdquo;。当你能顺着一个 &lt;code&gt;docker run&lt;/code&gt; 请求把这条链上的每一跳都讲清楚，你对 Go 容器生态的理解就已经上了一个台阶。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;五-为什么现在被归档-迁移路径&quot;&gt;五、为什么现在被归档？迁移路径&lt;/h2&gt;

&lt;p&gt;2017~2019 期间，Docker 逐步把引擎核心迁往 &lt;strong&gt;Moby 项目&lt;/strong&gt;：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;引擎核心 → &lt;code&gt;moby/moby&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;CLI → &lt;code&gt;docker/cli&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;打包定义 → 也在 &lt;code&gt;moby/moby&lt;/code&gt; 的 &lt;code&gt;packaging&lt;/code&gt; 目录及厂商侧维护&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;code&gt;docker-ce&lt;/code&gt; 作为&amp;rdquo;某一段时期官方打包工程&amp;rdquo;的历史产物被保留下来，&lt;strong&gt;只读归档&lt;/strong&gt;。如果你现在要做现代容器开发，应关注：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;code&gt;moby/moby&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;moby/buildkit&lt;/code&gt;（现代构建后端，强烈建议 Go 开发者研读）&lt;/li&gt;
&lt;li&gt;&lt;code&gt;containerd/containerd&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;opencontainers/runc&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;不过，&lt;strong&gt;归档 ≠ 无价值&lt;/strong&gt;。这个仓库仍然是你理解 &amp;ldquo;Docker 发行体系&amp;rdquo; 的最佳考古材料。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;六-给-go-开发者的阅读建议&quot;&gt;六、给 Go 开发者的阅读建议&lt;/h2&gt;

&lt;p&gt;如果你真想从这套仓库里学到东西，我建议按这个顺序走：&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;先读 &lt;code&gt;MANIFEST&lt;/code&gt; 与 &lt;code&gt;.gitmodules&lt;/code&gt;&lt;/strong&gt;：搞清一次发布涉及多少个 Go 仓库、它们的版本如何锁定。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;追踪一个 &lt;code&gt;docker&lt;/code&gt; 二进制的诞生&lt;/strong&gt;：从 &lt;code&gt;Makefile&lt;/code&gt; → &lt;code&gt;components/cli&lt;/code&gt; → 找到 &lt;code&gt;main.go&lt;/code&gt;，理解 CLI 如何用 cobra 组织命令。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;追踪 &lt;code&gt;dockerd&lt;/code&gt;&lt;/strong&gt;：进入 &lt;code&gt;moby/moby/cmd/dockerd&lt;/code&gt;，看它如何启动 API server、加载 containerd 客户端。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;追一次容器启动请求&lt;/strong&gt;：&lt;code&gt;docker run&lt;/code&gt; → CLI 组 HTTP 请求 → daemon → containerd &lt;code&gt;runtime/v2&lt;/code&gt; → runc。这是理解 Go 云原生编排最核心的一条线。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;对比打包脚本&lt;/strong&gt;：看 &lt;code&gt;deb/&lt;/code&gt; 与 &lt;code&gt;rpm/&lt;/code&gt; 下的规则，理解 Go 二进制如何被分装进系统包、如何写 systemd unit。&lt;/li&gt;
&lt;/ol&gt;

&lt;hr&gt;

&lt;h2 id=&quot;七-小结&quot;&gt;七、小结&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;docker-archive/docker-ce&lt;/code&gt; 是一个&lt;strong&gt;&amp;ldquo;被归档但极具教学价值&amp;rdquo;&lt;/strong&gt;的仓库。它本身不写业务 Go 代码，却是整个 Docker 生态的&lt;strong&gt;发布中枢与版本契约&lt;/strong&gt;：通过 &lt;code&gt;MANIFEST&lt;/code&gt; 锁定十几个 Go 组件的精确版本，通过 &lt;code&gt;components/&lt;/code&gt; 下的构建脚本把它们编译、打包成用户可安装的 &lt;code&gt;docker-ce&lt;/code&gt;。&lt;/p&gt;

&lt;p&gt;对于 Golang 开发者，它能给你三点关键启发：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;多仓库版本治理&lt;/strong&gt;：如何用一份清单协调十几个 Go 仓库的发布；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;可复现构建&lt;/strong&gt;：固定 SHA、固定工具链的工程实践；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;容器技术栈全链路&lt;/strong&gt;：把 CLI / daemon / containerd / runc 串成一条可追溯的调用链。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;读懂它，你不仅读懂了&amp;rdquo;一个 Go 项目如何被发布&amp;rdquo;，更读懂了&amp;rdquo;Docker 这套 Go 生态是如何被组装出来的&amp;rdquo;。&lt;/p&gt;

&lt;hr&gt;

&lt;p&gt;&lt;strong&gt;参考链接&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;仓库主页：&lt;a href=&quot;https://github.com/docker-archive/docker-ce&quot;&gt;https://github.com/docker-archive/docker-ce&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;Moby 项目：&lt;a href=&quot;https://github.com/moby/moby&quot;&gt;https://github.com/moby/moby&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;containerd：&lt;a href=&quot;https://github.com/containerd/containerd&quot;&gt;https://github.com/containerd/containerd&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;runc：&lt;a href=&quot;https://github.com/opencontainers/runc&quot;&gt;https://github.com/opencontainers/runc&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;docker/cli：&lt;a href=&quot;https://github.com/docker/cli&quot;&gt;https://github.com/docker/cli&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</description><pubDate>Sat, 21 Nov 2026 06:02:17 +0800</pubDate></item><item><title>探索 Pascal DF：一个面向现代开发的 Pascal 框架</title><link>https://zelig.cn/delphi/1521.html</link><description>&lt;p&gt;&lt;img src=&quot;/zb_users/upload/2026/11/202611121839479bbbd297eb7f.svg&quot; alt=&quot;探索 Pascal DF：一个面向现代开发的 Pascal 框架&quot;&gt;&lt;/p&gt;&lt;h1 id=&quot;探索-pascal-df-一个面向现代开发的-pascal-框架&quot;&gt;探索 Pascal DF：一个面向现代开发的 Pascal 框架&lt;/h1&gt;

&lt;h2 id=&quot;引言&quot;&gt;引言&lt;/h2&gt;

&lt;p&gt;在编程语言的长河中，Pascal 曾经是教学和快速应用开发的主力语言，但随着时间推移，它的生态逐渐收窄。然而，仍有一批开发者在努力让 Pascal 焕发新生。今天要介绍的是 &lt;strong&gt;Pascal DF&lt;/strong&gt;——一个托管在 GitHub 上的开源项目（&lt;a href=&quot;https://github.com/Doom2D/DF），它为&quot;&gt;https://github.com/Doom2D/DF），它为&lt;/a&gt; Pascal 开发者提供了一个现代化的框架工具集。&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;说明：由于项目名为 &amp;ldquo;DF&amp;rdquo;，并且仓库归属为 &lt;code&gt;Doom2D&lt;/code&gt;，本文从项目定位、目录结构、使用方式和典型场景几个角度进行介绍。具体 API 与功能细节请以仓库中的文档和源码为准。&lt;/p&gt;
&lt;/blockquote&gt;

&lt;hr&gt;

&lt;h2 id=&quot;什么是-pascal-df&quot;&gt;什么是 Pascal DF？&lt;/h2&gt;

&lt;p&gt;Pascal DF 是一个用 &lt;strong&gt;Object Pascal&lt;/strong&gt; 编写的框架/库集合，面向 Delphi 和 Free Pascal（FPC）生态。它的目标是：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;降低重复劳动&lt;/strong&gt;：把常见的底层操作（如内存、字符串、容器、I/O）封装成可复用的组件。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;保持 Pascal 风格&lt;/strong&gt;：沿用 Object Pascal 的类、记录、泛型等特性，不强制引入外部依赖。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;跨编译器友好&lt;/strong&gt;：尽量同时兼容 Delphi 与 FPC，减少平台迁移成本。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;它与 Doom2D 项目生态相关——Doom2D 是一个用 Pascal 实现的开源游戏引擎（受 Doom 风格启发）。DF 作为其中的基础库部分，提供了引擎运行所需要的基础设施支持。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;为什么需要这样一个框架&quot;&gt;为什么需要这样一个框架？&lt;/h2&gt;

&lt;p&gt;传统的 Pascal 项目往往面临这些问题：&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;标准库能力有限&lt;/strong&gt;：与主流语言的富标准库相比，Pascal 的 RTL 更偏底层。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;跨平台适配繁琐&lt;/strong&gt;：Windows、Linux、移动端 API 差异大。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;代码复用率低&lt;/strong&gt;：每个项目都重复造轮子（日志、配置、容器等）。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Pascal DF 的应对思路是：&lt;strong&gt;提供一层轻量的抽象&lt;/strong&gt;，让开发者专注于业务逻辑，而不是基础设施。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;核心能力概览&quot;&gt;核心能力概览&lt;/h2&gt;

&lt;p&gt;根据这类框架的一般设计，Pascal DF 通常覆盖以下几个维度：&lt;/p&gt;

&lt;h3 id=&quot;1-基础类型与工具&quot;&gt;1. 基础类型与工具&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;字符串处理：增强的字符串工具函数。&lt;/li&gt;
&lt;li&gt;数值与转换：安全的类型转换与校验。&lt;/li&gt;
&lt;li&gt;时间与日期：统一的日期时间辅助。&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;2-容器与数据结构&quot;&gt;2. 容器与数据结构&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;动态数组、列表、字典的封装。&lt;/li&gt;
&lt;li&gt;泛型支持（在编译器支持范围内）。&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;3-文件与-i-o&quot;&gt;3. 文件与 I/O&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;跨平台的路径处理。&lt;/li&gt;
&lt;li&gt;文件读写与流操作封装。&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;4-日志与调试&quot;&gt;4. 日志与调试&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;分级日志输出。&lt;/li&gt;
&lt;li&gt;断言与调试辅助。&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;5-平台抽象&quot;&gt;5. 平台抽象&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;屏蔽不同操作系统调用的差异。&lt;/li&gt;
&lt;/ul&gt;

&lt;blockquote&gt;
&lt;p&gt;以上为项目能力的合理归纳，实际模块划分请参考仓库源码中的单元（unit）组织。&lt;/p&gt;
&lt;/blockquote&gt;

&lt;hr&gt;

&lt;h2 id=&quot;快速上手&quot;&gt;快速上手&lt;/h2&gt;

&lt;h3 id=&quot;环境准备&quot;&gt;环境准备&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;安装 &lt;strong&gt;Free Pascal Compiler (FPC)&lt;/strong&gt; 或 &lt;strong&gt;Delphi&lt;/strong&gt;。&lt;/li&gt;
&lt;li&gt;克隆仓库：&lt;/li&gt;
&lt;/ul&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;git clone https://github.com/Doom2D/DF.git&lt;/pre&gt;

&lt;h3 id=&quot;引入单元&quot;&gt;引入单元&lt;/h3&gt;

&lt;p&gt;在项目中把源码目录加入搜索路径，然后在代码中 &lt;code&gt;uses&lt;/code&gt; 对应单元即可：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Pascal&quot;&gt;Pascal&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-pascal prism-line-numbers&quot; data-language=&quot;Pascal&quot;&gt;program Demo;

uses
  DF.SomeUnit;  // 按实际单元名替换

begin
  // 使用框架提供的功能
end.&lt;/pre&gt;

&lt;h3 id=&quot;典型使用模式&quot;&gt;典型使用模式&lt;/h3&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Pascal&quot;&gt;Pascal&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-pascal prism-line-numbers&quot; data-language=&quot;Pascal&quot;&gt;uses
  DF.Core;

var
  Logger: TDFLogger;
begin
  Logger := TDFLogger.Create;
  try
    Logger.Info(&#039;Pascal DF 已启动&#039;);
    Logger.Debug(&#039;Framework initialized.&#039;);
  finally
    Logger.Free;
  end;
end.&lt;/pre&gt;

&lt;p&gt;（示例为演示用结构，具体类名与 API 以仓库为准。）&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;适用场景&quot;&gt;适用场景&lt;/h2&gt;

&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;场景&lt;/th&gt;
&lt;th&gt;是否适合&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;

&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;游戏引擎底层库开发&lt;/td&gt;
&lt;td&gt;✅ 适合，与 Doom2D 生态一致&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;跨平台工具程序&lt;/td&gt;
&lt;td&gt;✅ 适合，平台抽象减轻移植负担&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;快速原型开发&lt;/td&gt;
&lt;td&gt;✅ 适合，复用组件减少样板代码&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;纯标准库可完成的小工具&lt;/td&gt;
&lt;td&gt;⚠️ 视需求而定，可能引入额外复杂度&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;

&lt;hr&gt;

&lt;h2 id=&quot;项目特点总结&quot;&gt;项目特点总结&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;纯 Pascal 实现&lt;/strong&gt;：无二进制依赖，代码可读、可改。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;轻量&lt;/strong&gt;：不像大型框架那样侵入项目结构。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;面向引擎与工具&lt;/strong&gt;：来自实际工程需求，而非纯理论设计。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;开源可学习&lt;/strong&gt;：对想深入理解 Object Pascal 工程实践的人是很好的学习材料。&lt;/li&gt;
&lt;/ol&gt;

&lt;hr&gt;

&lt;h2 id=&quot;深入阅读建议&quot;&gt;深入阅读建议&lt;/h2&gt;

&lt;p&gt;想进一步了解 Pascal DF，建议按以下路径阅读源码：&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;先看仓库根目录的 &lt;code&gt;README&lt;/code&gt;（如果有）与许可证。&lt;/li&gt;
&lt;li&gt;浏览各单元（&lt;code&gt;.pas&lt;/code&gt;）的开头注释，了解模块职责。&lt;/li&gt;
&lt;li&gt;找到入口 demo 或测试代码，理解典型调用链路。&lt;/li&gt;
&lt;li&gt;对照 Doom2D 主仓库，观察 DF 如何被实际使用。&lt;/li&gt;
&lt;/ol&gt;

&lt;hr&gt;

&lt;h2 id=&quot;结语&quot;&gt;结语&lt;/h2&gt;

&lt;p&gt;在 Pascal 生态相对小众的今天，像 Pascal DF 这样的开源项目是语言生命力的重要体现。它把实际工程中的经验沉淀为可复用的库，既服务于 Doom2D 自身，也为社区的 Pascal 开发者提供了一个值得参考与参与的基础设施。如果你正在用 Object Pascal 做跨平台项目，不妨 clone 下来读一读源码——即使不直接使用，也能从中学到不少框架设计的思路。&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;项目地址：&lt;/strong&gt; &lt;a href=&quot;https://github.com/Doom2D/DF&quot;&gt;https://github.com/Doom2D/DF&lt;/a&gt;&lt;/p&gt;

&lt;hr&gt;

&lt;p&gt;&lt;em&gt;注：本文基于仓库公开信息进行介绍，具体 API、模块名称与功能以项目实际源码和文档为准。欢迎到仓库提交 Issue 或 PR 参与贡献。&lt;/em&gt;&lt;/p&gt;
</description><pubDate>Sat, 21 Nov 2026 03:13:17 +0800</pubDate></item><item><title>Golang-Litmus：云原生混沌工程的利器</title><link>https://zelig.cn/golang/1520.html</link><description>&lt;p&gt;&lt;img src=&quot;/zb_users/upload/2026/11/202611121859313895253b09a8.png&quot; alt=&quot;Golang-Litmus：云原生混沌工程的利器&quot;&gt;&lt;/p&gt;&lt;h1 id=&quot;litmus-云原生混沌工程的利器&quot;&gt;Litmus：云原生混沌工程的利器&lt;/h1&gt;

&lt;h2 id=&quot;项目简介&quot;&gt;项目简介&lt;/h2&gt;

&lt;p&gt;&lt;a href=&quot;https://github.com/litmuschaos/litmus&quot;&gt;Litmus&lt;/a&gt; 是一个开源的云原生混沌工程平台（Cloud-Native Chaos Engineering Platform），目前是 CNCF（Cloud Native Computing Foundation）的孵化项目。它提供了一个完整的框架，用于在 Kubernetes 集群上进行混沌工程实验，帮助团队验证系统在故障场景下的可靠性和韧性。&lt;/p&gt;

&lt;p&gt;Litmus 最初由 MayaData 公司发起，后来捐赠给 CNCF，目前拥有活跃的社区和多种使用方式，包括 CLI 工具 &lt;code&gt;litmusctl&lt;/code&gt;、ChaosCenter 可视化控制台，以及作为 Chaos 资源的声明式 API。&lt;/p&gt;

&lt;h2 id=&quot;为什么需要混沌工程&quot;&gt;为什么需要混沌工程&lt;/h2&gt;

&lt;p&gt;在微服务和云原生架构中，系统组件之间的依赖关系复杂，任何一处故障（Pod 崩溃、网络延迟、节点宕机、磁盘 I/O 阻塞）都可能引发连锁反应。传统的测试只能验证&amp;rdquo;正常路径&amp;rdquo;，而混沌工程的核心思想是：&lt;strong&gt;主动向系统注入故障，观察系统的行为，从而在故障发生之前发现问题&lt;/strong&gt;。&lt;/p&gt;

&lt;p&gt;Litmus 正是把这一过程标准化、自动化、可重复的执行。&lt;/p&gt;

&lt;h2 id=&quot;架构组成&quot;&gt;架构组成&lt;/h2&gt;

&lt;p&gt;Litmus 的架构核心围绕 Kubernetes CRD（自定义资源定义）来构建：&lt;/p&gt;

&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;组件&lt;/th&gt;
&lt;th&gt;作用&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;

&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;ChaosCenter&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;图形化控制台，用于管理实验、查看仪表盘、调度运行&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;ChaosHub&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;混沌实验的仓库，托管社区贡献的 Chaos 实验模板（ChaosExperiment / ChaosFault）&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;ChaosEngine / ChaosExperiment&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;声明式定义&amp;rdquo;要在什么目标上执行什么故障、持续多久、成功条件是什么&amp;rdquo;&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;ChaosRunner&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;实际执行具体的混沌操作（如 kill container、注入网络延迟）&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;LitmusChaos Operator&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;监听 CRD 并协调整个实验生命周期&lt;/td&gt;
&lt;/tr&gt;

&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Litmusctl&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;命令行工具，支持对接自托管或云端 ChaosCenter&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;其中最有特色的是 &lt;strong&gt;Chaos 实验的声明式定义&lt;/strong&gt;。一个典型的实验定义如下：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;YAML&quot;&gt;YAML&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-yaml prism-line-numbers&quot; data-language=&quot;YAML&quot;&gt;apiVersion: litmuschaos.io/v1alpha1
kind: ChaosEngine
metadata:
  name: nginx-chaos
  namespace: default
spec:
  appinfo:
    appns: &#039;default&#039;
    applabel: &#039;app=nginx&#039;
    appkind: &#039;deployment&#039;
  chaosServiceAccount: pod-delete-sa
  experiments:
    - name: pod-delete
      spec:
        components:
          env:
            - name: TOTAL_CHAOS_DURATION
              value: &#039;30&#039;
            - name: CHAOS_INTERVAL
              value: &#039;10&#039;&lt;/pre&gt;

&lt;p&gt;以上例子表示：针对 &lt;code&gt;default&lt;/code&gt; 命名空间中标签为 &lt;code&gt;app=nginx&lt;/code&gt; 的 Deployment，每隔 10 秒删除一次 Pod，持续 30 秒。这就是一个标准的&amp;rdquo;Pod 删除&amp;rdquo;混沌实验。&lt;/p&gt;

&lt;h2 id=&quot;支持的故障类型&quot;&gt;支持的故障类型&lt;/h2&gt;

&lt;p&gt;Litmus 的 ChaosHub 中提供了数量众多的实验，大致可以分为几类：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Pod 级别故障&lt;/strong&gt;：pod-delete、pod-cpu-hog、pod-memory-hog、container-kill、pod-network-latency、pod-network-loss、pod-dns-error 等&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;节点级别故障&lt;/strong&gt;：node-drain、node-cpu-hog、node-memory-hog、node-io-stress 等&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Kubernetes 资源故障&lt;/strong&gt;：deployment-scale-down、statefulset-delete、k8s-target 等&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;云服务类故障&lt;/strong&gt;：AWS/EC2、GCP、Azure 相关的实验（如 cloud-instance-stop）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;应用故障&lt;/strong&gt;：HTTP 请求中断、MySQL/Redis 连接故障、Spring Boot 特定故障等&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;这些实验都可以作为模板直接使用，也可以基于 Go SDK 自行编写新的 Chaos 实验。&lt;/p&gt;

&lt;h2 id=&quot;使用方式&quot;&gt;使用方式&lt;/h2&gt;

&lt;h3 id=&quot;1-安装-chaoscenter-推荐&quot;&gt;1. 安装 ChaosCenter（推荐）&lt;/h3&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;# 使用 Helm 安装 Litmus Portal
helm repo add litmuschaos https://litmuschaos.github.io/litmus-helm/
helm install chaos litmuschaos/litmus --namespace litmus --create-namespace&lt;/pre&gt;

&lt;p&gt;安装后可通过浏览器访问 ChaosCenter，图形化管理实验、调度、查看结果。&lt;/p&gt;

&lt;h3 id=&quot;2-使用-litmusctl-命令行&quot;&gt;2. 使用 litmusctl 命令行&lt;/h3&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;# 安装 litmusctl
curl -O https://litmuschaos.github.io/litmus/litmusctl-linux-amd64.tar.gz
tar -xvf litmusctl-linux-amd64.tar.gz

# 连接 ChaosCenter
litmusctl config set-account --endpoint=&amp;quot;http://litmus.example.com&amp;quot;

# 创建实验
litmusctl create chaos-experiment -f chaos-experiment.yaml&lt;/pre&gt;

&lt;h3 id=&quot;3-直接以-kubernetes-资源方式部署&quot;&gt;3. 直接以 Kubernetes 资源方式部署&lt;/h3&gt;

&lt;p&gt;对于不想要 ChaosCenter 的场景，可以直接 &lt;code&gt;kubectl apply&lt;/code&gt; ChaosEngine 和 ChaosExperiment 资源，让 Operator 驱动执行，这也是最适合嵌入式 CI/CD 流程的方式。&lt;/p&gt;

&lt;h2 id=&quot;生产实践建议&quot;&gt;生产实践建议&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;从命名空间隔离开始&lt;/strong&gt;：Chaos 实验本身有风险，建议先在非生产环境执行，逐步建立信心。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;结合 SLO 判断实验成功&lt;/strong&gt;：不要只看&amp;rdquo;实验是否完成&amp;rdquo;，而要通过监控指标判断业务是否在故障注入期间保持可接受的服务水平。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;加入 CI/CD 流程&lt;/strong&gt;：在发布流水线中加入小规模的混沌实验，作为发布前的可靠性门禁。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;从简单实验开始&lt;/strong&gt;：如 pod-delete，先验证应用是否有足够的冗余和自愈能力，再逐步扩展到网络、节点层面的故障。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;利用 GameDay 模式&lt;/strong&gt;：团队定期组织&amp;rdquo;混沌日&amp;rdquo;，在受控的时间窗口内做故障演练。&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;与其他工具的比较&quot;&gt;与其他工具的比较&lt;/h2&gt;

&lt;p&gt;Litmus 的核心优势在于&lt;strong&gt;深度 Kubernetes 原生&lt;/strong&gt;：所有实验都是 CRD 声明式定义，天然适合 GitOps 流程；ChaosCenter 提供了较完整的可视化与调度能力；且实验模板库覆盖范围广。&lt;/p&gt;

&lt;p&gt;与其对比的工具包括 Chaos Mesh（同样是 CNCF 项目，更侧重 CNI 层面的网络故障，设计偏底层的 Kernel/网络隔离）、ChaosBlade（阿里巴巴开源，支持非 K8s 场景更广）、Gremlin（商业化产品，SaaS 为主）。Litmus 在&amp;rdquo;K8s 实验模板丰富度 + CNCF 生态&amp;rdquo;上有明显优势，特别是对于已经运行在 Kubernetes 上的微服务团队。&lt;/p&gt;

&lt;h2 id=&quot;总结&quot;&gt;总结&lt;/h2&gt;

&lt;p&gt;Litmus 把混沌工程从一种&amp;rdquo;手工技巧&amp;rdquo;变成了&amp;rdquo;云原生工程实践&amp;rdquo;。它通过 CRD 声明式 API、丰富的实验模板库、ChaosCenter 图形化平台以及 CLI 工具，让团队能够系统化地构建、运行和验证混沌实验。对于追求高可用性的 Kubernetes 团队来说，Litmus 是一个很值得纳入技术栈的可靠性工程工具。&lt;/p&gt;

&lt;p&gt;如果你正在构建面向生产的 K8s 平台，不妨从一个简单的 &lt;code&gt;pod-delete&lt;/code&gt; 实验开始，让 Litmus 帮你回答那个关键问题：&lt;strong&gt;&amp;ldquo;当故障发生时，我的系统真的能扛住吗？&amp;rdquo;&lt;/strong&gt;&lt;/p&gt;
</description><pubDate>Sat, 21 Nov 2026 00:09:17 +0800</pubDate></item><item><title>Golang-req：Go 语言里让人上瘾的 HTTP 客户端</title><link>https://zelig.cn/golang/1519.html</link><description>&lt;p&gt;&lt;img src=&quot;/zb_users/upload/2026/11/2026111218592076d2f1beff16.svg&quot; alt=&quot;Golang-req：Go 语言里让人上瘾的 HTTP 客户端&quot;&gt;&lt;/p&gt;&lt;h1 id=&quot;req-go-语言里让人上瘾的-http-客户端&quot;&gt;req：Go 语言里让人上瘾的 HTTP 客户端&lt;/h1&gt;

&lt;p&gt;如果你写过一段时间 Go，大概率用过标准库 &lt;code&gt;net/http&lt;/code&gt;。它很稳，但写起来啰嗦：构造请求、设置 Header、处理 Body、反序列化 JSON、错误处理……一个简单的 GET 请求往往要写七八行。&lt;/p&gt;

&lt;p&gt;&lt;code&gt;req&lt;/code&gt; 就是来解决这个痛点的。项目地址：&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;a href=&quot;https://github.com/imroc/req&quot;&gt;https://github.com/imroc/req&lt;/a&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;它是一个 Go 的 HTTP 客户端库，主打三个字：&lt;strong&gt;少写点&lt;/strong&gt;。不过别被它的简洁误导——简洁的外表下藏着相当完整的能力，API 风格类似 Python 的 &lt;code&gt;requests&lt;/code&gt;，用起来非常顺手。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;一-它到底有多简单&quot;&gt;一、它到底有多简单？&lt;/h2&gt;

&lt;p&gt;先看一个最普通的 GET 请求：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Go&quot;&gt;Go&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-go prism-line-numbers&quot; data-language=&quot;Go&quot;&gt;resp, err := req.Get(&amp;quot;https://httpbin.org/get&amp;quot;)
if err != nil {
    panic(err)
}
fmt.Println(resp.StatusCode())
fmt.Println(resp.String())&lt;/pre&gt;

&lt;p&gt;没有 &lt;code&gt;http.NewRequest&lt;/code&gt;，没有 &lt;code&gt;client.Do&lt;/code&gt;，没有手动 &lt;code&gt;io.ReadAll&lt;/code&gt; 再 &lt;code&gt;defer resp.Body.Close()&lt;/code&gt;。&lt;code&gt;req&lt;/code&gt; 全都帮你处理好了。&lt;/p&gt;

&lt;p&gt;发 POST 并带上 JSON：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Go&quot;&gt;Go&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-go prism-line-numbers&quot; data-language=&quot;Go&quot;&gt;r, err := req.Post(&amp;quot;https://httpbin.org/post&amp;quot;, req.BodyJSON(map[string]any{
    &amp;quot;name&amp;quot;: &amp;quot;imroc&amp;quot;,
    &amp;quot;age&amp;quot;:  18,
}))&lt;/pre&gt;

&lt;p&gt;想顺便把响应 JSON 解析到结构体里？一行搞定：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Go&quot;&gt;Go&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-go prism-line-numbers&quot; data-language=&quot;Go&quot;&gt;var result struct {
    Json map[string]any `json:&amp;quot;json&amp;quot;`
}
r, err := req.Post(&amp;quot;https://httpbin.org/post&amp;quot;, req.BodyJSON(map[string]any{&amp;quot;a&amp;quot;: 1})).
    SetResult(&amp;amp;result).
    Do()&lt;/pre&gt;

&lt;p&gt;这就是 &lt;code&gt;req&lt;/code&gt; 的核心设计思路：&lt;strong&gt;把请求的各个要素做成链式方法&lt;/strong&gt;，读起来几乎和自然语言一样。&lt;code&gt;SetResult&lt;/code&gt; 负责把响应体反序列化进目标变量，&lt;code&gt;SetError&lt;/code&gt; 负责错误响应，&lt;code&gt;SetHeader&lt;/code&gt;、&lt;code&gt;SetQueryParam&lt;/code&gt;、&lt;code&gt;SetBasicAuth&lt;/code&gt;、&lt;code&gt;SetBearerToken&lt;/code&gt; 各司其职。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;二-链式-api-的优雅之处&quot;&gt;二、链式 API 的优雅之处&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;req&lt;/code&gt; 的请求对象是可链式调用的，这带来的好处是：&lt;strong&gt;一个 HTTP 请求的完整语义可以在一行代码里表达清楚&lt;/strong&gt;。&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Go&quot;&gt;Go&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-go prism-line-numbers&quot; data-language=&quot;Go&quot;&gt;r, err := req.New().
    SetMethod(&amp;quot;PUT&amp;quot;).
    SetURL(&amp;quot;https://httpbin.org/put&amp;quot;).
    SetHeader(&amp;quot;X-Token&amp;quot;, &amp;quot;abc&amp;quot;).
    SetQueryParam(&amp;quot;page&amp;quot;, &amp;quot;1&amp;quot;).
    SetBody(map[string]any{&amp;quot;hello&amp;quot;: &amp;quot;world&amp;quot;}).
    SetContentType(&amp;quot;application/json&amp;quot;).
    Do()&lt;/pre&gt;

&lt;p&gt;等价于你在 &lt;code&gt;net/http&lt;/code&gt; 里要写十几行、还要处理各种 error 的代码。而且它内置了常见的便捷方法：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;code&gt;req.Get&lt;/code&gt; / &lt;code&gt;req.Post&lt;/code&gt; / &lt;code&gt;req.Put&lt;/code&gt; / &lt;code&gt;req.Delete&lt;/code&gt; / &lt;code&gt;req.Patch&lt;/code&gt; / &lt;code&gt;req.Head&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;req.BodyJSON(v)&lt;/code&gt; / &lt;code&gt;req.BodyXML(v)&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;req.QueryParam(k, v)&lt;/code&gt; / &lt;code&gt;req.Header(k, v)&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;req.BasicAuth(user, pass)&lt;/code&gt; / &lt;code&gt;req.BearerToken(token)&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;对于大部分日常请求，用包级函数就够了；需要复用配置时，再自己创建 client。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;三-client-配置一次-处处复用&quot;&gt;三、Client：配置一次，处处复用&lt;/h2&gt;

&lt;p&gt;跟 &lt;code&gt;http.Client&lt;/code&gt; 一样，你可以创建一个带默认配置的 client，比如统一设置 BaseURL、超时、重试策略、代理：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Go&quot;&gt;Go&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-go prism-line-numbers&quot; data-language=&quot;Go&quot;&gt;client := req.C().
    SetBaseURL(&amp;quot;https://api.example.com&amp;quot;).
    SetTimeout(5 * time.Second).
    SetCommonHeader(&amp;quot;User-Agent&amp;quot;, &amp;quot;my-app/1.0&amp;quot;)

resp, err := client.R().
    SetQueryParam(&amp;quot;q&amp;quot;, &amp;quot;golang&amp;quot;).
    Get(&amp;quot;/search&amp;quot;)&lt;/pre&gt;

&lt;p&gt;注意 &lt;code&gt;SetBaseURL&lt;/code&gt; + 相对路径这个组合，在写封装 SDK 时特别舒服。不用在每个方法里拼字符串。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;四-容易被低估的杀手锏功能&quot;&gt;四、容易被低估的杀手锏功能&lt;/h2&gt;

&lt;p&gt;如果只是 API 简洁，&lt;code&gt;req&lt;/code&gt; 大概只能算&amp;rdquo;语法糖&amp;rdquo;。真正让我持续用它的，是它把很多&lt;strong&gt;工程化才需要的东西&lt;/strong&gt;内置了。&lt;/p&gt;

&lt;h3 id=&quot;1-自动重试&quot;&gt;1. 自动重试&lt;/h3&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Go&quot;&gt;Go&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-go prism-line-numbers&quot; data-language=&quot;Go&quot;&gt;client := req.C().
    SetRetryCount(3).
    SetRetryInterval(func(r *req.Response, attempt int) time.Duration {
        return time.Duration(attempt) * time.Second
    })&lt;/pre&gt;

&lt;p&gt;配合 &lt;code&gt;SetRetryFixedInterval&lt;/code&gt;、&lt;code&gt;SetRetryMaxWaitTime&lt;/code&gt;，以及自定义的 &lt;code&gt;SetRetryCondition&lt;/code&gt;（判断哪些响应/错误需要重试），基本覆盖了生产场景的兜底需求。开箱即用的幂等重试，省去了自己写循环和退避逻辑。&lt;/p&gt;

&lt;h3 id=&quot;2-全自动-http-调试&quot;&gt;2. 全自动 HTTP 调试&lt;/h3&gt;

&lt;p&gt;这是 &lt;code&gt;req&lt;/code&gt; 非常讨喜的一个点。设置一个环境变量或一行开关，就能把请求和响应完整地打到控制台：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Go&quot;&gt;Go&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-go prism-line-numbers&quot; data-language=&quot;Go&quot;&gt;client := req.C().EnableDumpAll()
// 或者 req.EnableDebugLog()、EnableDebugLogWithFunc(...)&lt;/pre&gt;

&lt;p&gt;它会把请求行、Header、响应状态、Body 按 curl 可复现的格式输出。调第三方接口的时候，直接把 Dump 内容复制成 curl 命令贴到终端验证，效率极高。&lt;/p&gt;

&lt;h3 id=&quot;3-内置可视化-debug-工具&quot;&gt;3. 内置可视化 Debug 工具&lt;/h3&gt;

&lt;p&gt;&lt;code&gt;req&lt;/code&gt; 还附带了一个叫 &lt;strong&gt;req/debug&lt;/strong&gt;（原 &lt;code&gt;req.DebugLog&lt;/code&gt;、&lt;code&gt;req.Trace&lt;/code&gt;）的能力，可以开一个本地 Web UI，可视化查看每次请求的详情，支持查看响应体、导入为 curl、重放等。类似浏览器的 Network 面板，但作用在 Go 进程里。排查偶发问题时特别有用。&lt;/p&gt;

&lt;h3 id=&quot;4-网络抓包与自定义-transport&quot;&gt;4. 网络抓包与自定义 Transport&lt;/h3&gt;

&lt;p&gt;它支持挂载 &lt;code&gt;httptrace&lt;/code&gt;、设置自定义 &lt;code&gt;http.RoundTripper&lt;/code&gt;、接入代理，也能拿到 DNS、连接、TLS 等阶段耗时：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Go&quot;&gt;Go&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-go prism-line-numbers&quot; data-language=&quot;Go&quot;&gt;client := req.C().EnableTrace()      // 开启调用链耗时统计
client := req.C().SetTransport(...)  // 替换底层 Transport&lt;/pre&gt;

&lt;h3 id=&quot;5-上传下载都很顺手&quot;&gt;5. 上传下载都很顺手&lt;/h3&gt;

&lt;p&gt;上传文件：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Go&quot;&gt;Go&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-go prism-line-numbers&quot; data-language=&quot;Go&quot;&gt;r, err := req.Post(url, req.FileUpload{
    FileField: &amp;quot;file&amp;quot;,
    FileName:  &amp;quot;a.png&amp;quot;,
    FilePath:  &amp;quot;./a.png&amp;quot;,
})&lt;/pre&gt;

&lt;p&gt;或者用 &lt;code&gt;req.MultipartUpload&lt;/code&gt; 更精细地控制。下载的话，直接 &lt;code&gt;resp.ToFile(&amp;quot;out.zip&amp;quot;)&lt;/code&gt;。断点续传、进度回调（&lt;code&gt;SetOutput&lt;/code&gt; + 自定义 Writer）也都能组合实现。&lt;/p&gt;

&lt;h3 id=&quot;6-中间件式-hook&quot;&gt;6. 中间件式 Hook&lt;/h3&gt;

&lt;p&gt;&lt;code&gt;req&lt;/code&gt; 提供了 &lt;code&gt;AddClientHook&lt;/code&gt;、&lt;code&gt;SetPreRequestHook&lt;/code&gt;、&lt;code&gt;SetResponseHandler&lt;/code&gt; 等钩子，可以在请求前后、响应后插入逻辑，比如打日志、加签名、统一加 trace id——写基础设施封装的时候非常灵活。&lt;/p&gt;

&lt;h3 id=&quot;7-与标准库无缝互通&quot;&gt;7. 与标准库无缝互通&lt;/h3&gt;

&lt;p&gt;它支持通过 &lt;code&gt;SetContext&lt;/code&gt; 传入 &lt;code&gt;context.Context&lt;/code&gt;，支持 &lt;code&gt;httputil&lt;/code&gt;、&lt;code&gt;http.CookieJar&lt;/code&gt;、&lt;code&gt;http.Transport&lt;/code&gt;，甚至能把 &lt;code&gt;*http.Request&lt;/code&gt; 塞进去。也就是说，你已有的 &lt;code&gt;net/http&lt;/code&gt; 体系不用推倒重来。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;五-性能与稳定性&quot;&gt;五、性能与稳定性&lt;/h2&gt;

&lt;p&gt;很多人会担心&amp;rdquo;封装这么好，是不是性能拉胯&amp;rdquo;。实际上 &lt;code&gt;req&lt;/code&gt; 的 base 就是 &lt;code&gt;net/http&lt;/code&gt;，它不做额外的 goroutine 或反射重活，绝大多数调用只是方法链上的字段赋值。官方也提供了 benchmark 跑分，和裸 &lt;code&gt;net/http&lt;/code&gt; 相比在一个数量级。&lt;/p&gt;

&lt;p&gt;稳定性方面，项目维护活跃、star 数万级、发布走语义化版本，被不少生产项目采用。作者 imroc 也是 Go 社区里比较活跃的开发者（写过不少高质量的 Go 相关内容）。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;六-它适合谁&quot;&gt;六、它适合谁？&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;调第三方 API 的服务&lt;/strong&gt;：&lt;code&gt;SetBaseURL&lt;/code&gt; + 重试 + Dump，一天能省一小时。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;写内部 SDK / 客户端封装&lt;/strong&gt;：链式 API + Hook + Client 复用，封装出来的东西又薄又好用。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;脚本和 CLI 工具&lt;/strong&gt;：一行一请求，比标准库舒服太多。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;需要排查线上 HTTP 问题的场景&lt;/strong&gt;：可视化 debug 和 trace 直接救命。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;当然，如果你追求极致轻量、连依赖都不想引入，标准库无可替代。但对于绝大多数业务服务，&lt;code&gt;req&lt;/code&gt; 的收益远大于它带来的依赖成本。&lt;/p&gt;

&lt;hr&gt;

&lt;h2 id=&quot;七-一句话总结&quot;&gt;七、一句话总结&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;req&lt;/code&gt; 是那种&amp;rdquo;用过就回不去&amp;rdquo;的库：&lt;strong&gt;上手成本几乎为零，功能深度却经常给人惊喜&lt;/strong&gt;。它把 HTTP 客户端该有的简洁、可观测性、工程化能力都照顾到了，却依然保持了非常小的 API 表面。&lt;/p&gt;

&lt;p&gt;如果你还在为每个项目反复手写 &lt;code&gt;http.NewRequest&lt;/code&gt; + &lt;code&gt;io.ReadAll&lt;/code&gt; + JSON 解析，那真该试一下：&lt;/p&gt;
&lt;div class=&quot;prism-show-language&quot;&gt;&lt;div class=&quot;prism-show-language-label&quot; data-language=&quot;Bash&quot;&gt;Bash&lt;/div&gt;&lt;/div&gt;&lt;pre class=&quot;prism-highlight prism-language-bash prism-line-numbers&quot; data-language=&quot;Bash&quot;&gt;go get github.com/imroc/req/v3&lt;/pre&gt;

&lt;p&gt;项目地址再放一次：&lt;strong&gt;&lt;a href=&quot;https://github.com/imroc/req&quot;&gt;https://github.com/imroc/req&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;写得好不如用得好，找个接口试一手，你就明白我在说什么了。&lt;/p&gt;
</description><pubDate>Fri, 20 Nov 2026 20:00:17 +0800</pubDate></item></channel></rss>