summaryrefslogtreecommitdiff
path: root/2026/03
diff options
context:
space:
mode:
authormuqiuhan <[email protected]>2026-03-16 14:29:05 +0000
committermuqiuhan <[email protected]>2026-03-16 14:29:05 +0000
commit92f6996da990bbe944fb0b48305acd5d5c970da2 (patch)
treee9fcf2990e408af3d8a50db6849b0780d67e6f62 /2026/03
parent25917ed0c1e01b6d7cc2ddac5bfca1c4238e96c2 (diff)
downloadblog-92f6996da990bbe944fb0b48305acd5d5c970da2.tar.gz
deploy: 4038692e4b425756edcb51cf7973793e280812ae
Diffstat (limited to '2026/03')
-rw-r--r--2026/03/06/Tacrolimus-for-Stasis-Dermatitis-in-Palliative-Heart-Failure-and-COPD/index.html13
-rw-r--r--2026/03/12/简单说说-FHIR-Transaction-Bundle/index.html284
-rw-r--r--2026/03/16/Nginx-前后端同域分流/index.html266
3 files changed, 559 insertions, 4 deletions
diff --git a/2026/03/06/Tacrolimus-for-Stasis-Dermatitis-in-Palliative-Heart-Failure-and-COPD/index.html b/2026/03/06/Tacrolimus-for-Stasis-Dermatitis-in-Palliative-Heart-Failure-and-COPD/index.html
index f8521f3e..a1ee0123 100644
--- a/2026/03/06/Tacrolimus-for-Stasis-Dermatitis-in-Palliative-Heart-Failure-and-COPD/index.html
+++ b/2026/03/06/Tacrolimus-for-Stasis-Dermatitis-in-Palliative-Heart-Failure-and-COPD/index.html
@@ -269,11 +269,11 @@
J -->|有效| K[长期维持]
J -->|部分有效| L[联合口服加巴喷丁]
J -->|无效| M[重新评估诊断]</pre>
-<p>急性控制阶段为1<sub>2周。重度瘙痒(VAS≥7分)或炎症明显者,先用外用强效糖皮质激素快速控制,选用丙酸氯倍他索0.05%乳膏或卤米松0.05%乳膏,每日1</sub>2次,薄涂于瘙痒区域,疗程不超过2周,联合润肤剂(尿素10%~20%或神经酰胺类)。</p>
+<p>急性控制阶段为 1~2 周。重度瘙痒(VAS≥7分)或炎症明显者,先用外用强效糖皮质激素快速控制,选用丙酸氯倍他索0.05%乳膏或卤米松0.05%乳膏,每日 1~2 次,薄涂于瘙痒区域,疗程不超过2周,联合润肤剂(尿素10%~20%或神经酰胺类)。</p>
<p>过渡阶段为第2~3周,逐步过渡至他克莫司。激素减量(隔日使用或换用弱效激素),同时启动他克莫司0.03%软膏每日2次,两药可交替使用(晨用激素,晚用他克莫司)。</p>
<p>维持阶段为第4周起。他克莫司0.03%或0.1%软膏每日2次,症状控制后可减至每日1次或隔日使用,润肤剂持续使用,无固定疗程限制。</p>
-<p>制剂选择方面,初始使用0.03%浓度(刺激性较低),耐受良好者可换用0.1%浓度(疗效更强),软膏基质优于乳膏(保湿性更好)。使用方法为清洁皮肤后薄涂于患处,轻柔按摩至吸收,避免大面积使用(单次&lt;10%体表面积),避免封包(增加系统吸收),涂抹后洗手。预处理减轻刺激的方法包括:首次使用前冷敷5<sub>10分钟;或先使用润肤剂,待吸收后再涂他克莫司;刺激感通常1</sub>2周后缓解。</p>
-<p>基础治疗包括润肤剂每日至少1次(沐浴后立即使用)、抬高患肢每日数次每次15<sub>30分钟、压力治疗(需排除动脉疾病后使用)。外用治疗效果不足者可联合口服药物:加巴喷丁100</sub>300 mg qn起始,缓慢加量;普瑞巴林25~75 mg qn起始;米氮平7.5~15 mg qn(心衰患者需谨慎)。</p>
+<p>制剂选择方面,初始使用0.03%浓度(刺激性较低),耐受良好者可换用0.1%浓度(疗效更强),软膏基质优于乳膏(保湿性更好)。使用方法为清洁皮肤后薄涂于患处,轻柔按摩至吸收,避免大面积使用(单次&lt;10%体表面积),避免封包(增加系统吸收),涂抹后洗手。预处理减轻刺激的方法包括:首次使用前冷敷 5~10 分钟;或先使用润肤剂,待吸收后再涂他克莫司;刺激感通常1~2周后缓解。</p>
+<p>基础治疗包括润肤剂每日至少1次(沐浴后立即使用)、抬高患肢每日数次每次 15~30 分钟、压力治疗(需排除动脉疾病后使用)。外用治疗效果不足者可联合口服药物:加巴喷丁100~300 mg qn起始,缓慢加量;普瑞巴林25~75 mg qn起始;米氮平7.5~15 mg qn(心衰患者需谨慎)。</p>
<hr>
<h2 id="监测与随访"><a class="header-anchor" href="#监测与随访">¶</a>监测与随访</h2>
<p>疗效评估采用瘙痒视觉模拟评分(VAS,0~10分)、5-D Itch Scale多维瘙痒评估、皮肤病生活质量指数(DLQI)、患者主观满意度。评估时点为基线、治疗1周、治疗2周、治疗4周,此后每月评估。有效标准为VAS下降≥3分,或瘙痒对睡眠影响显著减少,或患者主观满意度≥满意。</p>
@@ -303,12 +303,17 @@
<nav class="post-nav">
<div class="prev-item">
+ <div class="icon arrow-left"></div>
+ <div class="post-link">
+ <a href="/2026/03/12/%E7%AE%80%E5%8D%95%E8%AF%B4%E8%AF%B4-FHIR-Transaction-Bundle/">Prev</a>
+ </div>
+
</div>
<div class="next-item">
<div class="icon arrow-right"></div>
<div class="post-link">
- <a href="/2025/12/30/%E4%B9%99%E9%85%B0%E5%8D%8A%E8%84%B1%E6%B0%A8%E9%85%B8%E7%9A%84%E8%8D%AF%E7%90%86%E5%AD%A6%E4%B8%8E%E8%8D%AF%E4%BB%A3%E5%8A%A8%E5%8A%9B%E5%AD%A6%E7%89%B9%E6%80%A7/">Next</a>
+ <a href="/2026/02/16/%E8%80%81%E5%B9%B4%E4%BA%BA%E8%90%A5%E5%85%BB%E8%AF%AF%E5%8C%BA/">Next</a>
</div>
</div>
diff --git a/2026/03/12/简单说说-FHIR-Transaction-Bundle/index.html b/2026/03/12/简单说说-FHIR-Transaction-Bundle/index.html
new file mode 100644
index 00000000..7b639cf2
--- /dev/null
+++ b/2026/03/12/简单说说-FHIR-Transaction-Bundle/index.html
@@ -0,0 +1,284 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
+<meta http-equiv="X-UA-Compatible" content="ie=edge">
+
+ <meta name="author" content="韩暮秋">
+
+
+ <meta name="subtitle" content="暮秋小屋">
+
+
+ <meta name="description" content="这里是暮秋小屋,思念和灵感的寄存处">
+
+
+ <meta name="keywords" content="韩暮秋,MuqiuHan,'Muqiu Han', 'muqiu han', muqiuhan">
+
+
+
+
+ <title>
+
+ 简单说说 FHIR Transaction Bundle |
+ 暮秋小屋
+ </title>
+
+
+
+ <link rel="icon" href="/favicon.ico">
+
+
+
+
+ <!-- stylesheets list from _config.yml -->
+
+ <link rel="stylesheet" href="/css/style.css">
+
+
+
+
+ <link rel="preload" href="/fonts/latin-base.woff2" as="font" type="font/woff2" crossorigin>
+ <link rel="preload" href="/fonts/cjk-common.woff2" as="font" type="font/woff2" crossorigin>
+
+
+
+ <!-- scripts list from _config.yml -->
+
+ <script
+ src="/js/menu.js"></script>
+
+
+
+
+
+ <script
+ src="https://polyfill.alicdn.com/polyfill.js?features=es6"></script>
+ <script
+ id="MathJax-script"
+ async
+ src="https://lf6-cdn-tos.bytecdntp.com/cdn/expire-1-M/mathjax/3.2.0/es5/tex-mml-chtml.js"></script>
+
+
+
+
+ <meta name="generator" content="Hexo 6.3.0"></head>
+ <body>
+ <div class="wrapper">
+
+ <div class="header">
+ <div class="flex-container">
+ <div class="header-inner">
+ <div class="site-brand-container">
+ <a href="/">
+
+ 暮秋小屋
+
+ </a>
+ </div>
+ <div id="menu-btn" class="menu-btn" onclick="toggleMenu()">
+ 菜单
+ </div>
+ <nav class="site-nav">
+ <ul class="menu-list">
+
+
+ <li class="menu-item">
+ <a href="/">
+ 主页
+ </a>
+ </li>
+
+
+
+ <li class="menu-item">
+ <a href="/categories/gallery/">
+ 日记本
+ </a>
+ </li>
+
+
+
+ <li class="menu-item">
+ <a href="/tags/Medicine/">
+ 泛医学
+ </a>
+ </li>
+
+
+
+ <li class="menu-item">
+ <a href="/tags/Technique/">
+ 计算机
+ </a>
+ </li>
+
+
+
+ <li class="menu-item">
+ <a href="/tags/Life/">
+ 生活
+ </a>
+ </li>
+
+
+
+ <li class="menu-item">
+ <a href="/archives">
+ 全部
+ </a>
+ </li>
+
+
+
+ <li class="menu-item">
+ <a href="/about">
+ 关于
+ </a>
+ </li>
+
+
+
+ <li class="menu-item">
+ <a href="/search">搜索</a>
+ </li>
+
+ </ul>
+ </nav>
+ </div>
+ </div>
+</div>
+
+
+ <div class="main">
+ <div class="flex-container">
+ <article id="post">
+
+
+ <div class="post-head">
+ <div class="post-info">
+ <div class="tag-list">
+
+
+ <span class="post-tag">
+ <a href="/tags/Technique/">
+ Technique
+ </a>
+ </span>
+
+
+ </div>
+ <div class="post-title">
+
+
+ 简单说说 FHIR Transaction Bundle
+
+
+ </div>
+ <span class="post-date">
+ Mar 12, 2026
+ </span>
+ </div>
+ <div class="post-img">
+
+ <div class="h-line-primary"></div>
+
+ </div>
+</div>
+ <div class="post-content">
+ <p>FHIR Transaction Bundle 主要解决这一类问题:</p>
+<blockquote>
+<p>假设你要创建一个 Patient,再创建一个属于这个患者的 Observation,两个必须同时成功或同时失败。用普通 REST API,你得先 POST Patient,拿到 ID,再 POST Observation,如果中间失败了还得自己回滚。FHIR 的 transaction 就是把这个流程标准化成类似数据库的事务操作或说是 “原子操作” ,整组操作要么全成功,要么全失败,而且可以在同一个 bundle 里直接引用还没创建的资源。</p>
+</blockquote>
+<p>transaction bundle 和 batch bundle 的区别是,batch 把多个请求一起提交,每个独立处理,一部分成功一部分失败是允许的。Transaction 是把所有请求当原子单元处理,任一失败则整体回滚。Medplum 文档说得很直接:batch 是独立处理,transaction 是原子处理。</p>
+<p>然后看一个最基础的例子。同时创建 Patient 和 Observation,Observation 引用这个新建的 Patient:</p>
+<figure class="highlight json"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br><span class="line">22</span><br><span class="line">23</span><br><span class="line">24</span><br><span class="line">25</span><br><span class="line">26</span><br><span class="line">27</span><br><span class="line">28</span><br><span class="line">29</span><br><span class="line">30</span><br><span class="line">31</span><br></pre></td><td class="code"><pre><span class="line"><span class="punctuation">&#123;</span></span><br><span class="line"> <span class="attr">&quot;resourceType&quot;</span><span class="punctuation">:</span> <span class="string">&quot;Bundle&quot;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;type&quot;</span><span class="punctuation">:</span> <span class="string">&quot;transaction&quot;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;entry&quot;</span><span class="punctuation">:</span> <span class="punctuation">[</span></span><br><span class="line"> <span class="punctuation">&#123;</span></span><br><span class="line"> <span class="attr">&quot;fullUrl&quot;</span><span class="punctuation">:</span> <span class="string">&quot;urn:uuid:patient-1&quot;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;request&quot;</span><span class="punctuation">:</span> <span class="punctuation">&#123;</span></span><br><span class="line"> <span class="attr">&quot;method&quot;</span><span class="punctuation">:</span> <span class="string">&quot;POST&quot;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;url&quot;</span><span class="punctuation">:</span> <span class="string">&quot;Patient&quot;</span></span><br><span class="line"> <span class="punctuation">&#125;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;resource&quot;</span><span class="punctuation">:</span> <span class="punctuation">&#123;</span></span><br><span class="line"> <span class="attr">&quot;resourceType&quot;</span><span class="punctuation">:</span> <span class="string">&quot;Patient&quot;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;name&quot;</span><span class="punctuation">:</span> <span class="punctuation">[</span><span class="punctuation">&#123;</span> <span class="attr">&quot;family&quot;</span><span class="punctuation">:</span> <span class="string">&quot;Doe&quot;</span><span class="punctuation">,</span> <span class="attr">&quot;given&quot;</span><span class="punctuation">:</span> <span class="punctuation">[</span><span class="string">&quot;Jane&quot;</span><span class="punctuation">]</span> <span class="punctuation">&#125;</span><span class="punctuation">]</span></span><br><span class="line"> <span class="punctuation">&#125;</span></span><br><span class="line"> <span class="punctuation">&#125;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="punctuation">&#123;</span></span><br><span class="line"> <span class="attr">&quot;fullUrl&quot;</span><span class="punctuation">:</span> <span class="string">&quot;urn:uuid:observation-1&quot;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;request&quot;</span><span class="punctuation">:</span> <span class="punctuation">&#123;</span></span><br><span class="line"> <span class="attr">&quot;method&quot;</span><span class="punctuation">:</span> <span class="string">&quot;POST&quot;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;url&quot;</span><span class="punctuation">:</span> <span class="string">&quot;Observation&quot;</span></span><br><span class="line"> <span class="punctuation">&#125;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;resource&quot;</span><span class="punctuation">:</span> <span class="punctuation">&#123;</span></span><br><span class="line"> <span class="attr">&quot;resourceType&quot;</span><span class="punctuation">:</span> <span class="string">&quot;Observation&quot;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;status&quot;</span><span class="punctuation">:</span> <span class="string">&quot;final&quot;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;code&quot;</span><span class="punctuation">:</span> <span class="punctuation">&#123;</span> <span class="attr">&quot;text&quot;</span><span class="punctuation">:</span> <span class="string">&quot;Body Weight&quot;</span> <span class="punctuation">&#125;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;subject&quot;</span><span class="punctuation">:</span> <span class="punctuation">&#123;</span> <span class="attr">&quot;reference&quot;</span><span class="punctuation">:</span> <span class="string">&quot;urn:uuid:patient-1&quot;</span> <span class="punctuation">&#125;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;valueQuantity&quot;</span><span class="punctuation">:</span> <span class="punctuation">&#123;</span> <span class="attr">&quot;value&quot;</span><span class="punctuation">:</span> <span class="number">68</span><span class="punctuation">,</span> <span class="attr">&quot;unit&quot;</span><span class="punctuation">:</span> <span class="string">&quot;kg&quot;</span> <span class="punctuation">&#125;</span></span><br><span class="line"> <span class="punctuation">&#125;</span></span><br><span class="line"> <span class="punctuation">&#125;</span></span><br><span class="line"> <span class="punctuation">]</span></span><br><span class="line"><span class="punctuation">&#125;</span></span><br></pre></td></tr></table></figure>
+<p>这里的关键是 <code>fullUrl</code> 和 <code>urn:uuid</code>。<code>fullUrl</code> 给 bundle 内还没创建的资源一个临时身份,其他资源通过这个 <code>urn:uuid</code> 引用它。服务端创建资源后会把内部引用替换成真实地址。</p>
+<p>FHIR R4 规范对 transaction 有几个硬性规则,这些规则直接影响你怎么设计 bundle。</p>
+<p>第一,原子性,要么全成功要么全失败。</p>
+<p>第二,处理结果不依赖 entry 顺序。这是我踩坑的地方。不能把 transaction 当成&quot;按顺序执行的脚本&quot;。FHIR 明确规定了服务端处理顺序:先 DELETE,再 POST,再 PUT/PATCH,最后 GET 和解析条件引用。所以写 bundle 的时候不能依赖&quot;先 A 再 B&quot;这种逻辑。</p>
+<p>第三,同一资源身份在一个 transaction 中只能出现一次。这是规范层面的限制,不是&quot;可能出问题&quot;,而是规范直接说 SHALL fail。</p>
+<p>举个反面例子。我想在一个 transaction 里先 PATCH 一个资源补审计字段,再 DELETE 同一个资源:</p>
+<figure class="highlight json"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br></pre></td><td class="code"><pre><span class="line"><span class="punctuation">&#123;</span></span><br><span class="line"> <span class="attr">&quot;resourceType&quot;</span><span class="punctuation">:</span> <span class="string">&quot;Bundle&quot;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;type&quot;</span><span class="punctuation">:</span> <span class="string">&quot;transaction&quot;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;entry&quot;</span><span class="punctuation">:</span> <span class="punctuation">[</span></span><br><span class="line"> <span class="punctuation">&#123;</span></span><br><span class="line"> <span class="attr">&quot;request&quot;</span><span class="punctuation">:</span> <span class="punctuation">&#123;</span> <span class="attr">&quot;method&quot;</span><span class="punctuation">:</span> <span class="string">&quot;PATCH&quot;</span><span class="punctuation">,</span> <span class="attr">&quot;url&quot;</span><span class="punctuation">:</span> <span class="string">&quot;Observation/obs-1&quot;</span> <span class="punctuation">&#125;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="attr">&quot;resource&quot;</span><span class="punctuation">:</span> <span class="punctuation">&#123;</span> <span class="attr">&quot;resourceType&quot;</span><span class="punctuation">:</span> <span class="string">&quot;Parameters&quot;</span> <span class="punctuation">&#125;</span></span><br><span class="line"> <span class="punctuation">&#125;</span><span class="punctuation">,</span></span><br><span class="line"> <span class="punctuation">&#123;</span></span><br><span class="line"> <span class="attr">&quot;request&quot;</span><span class="punctuation">:</span> <span class="punctuation">&#123;</span> <span class="attr">&quot;method&quot;</span><span class="punctuation">:</span> <span class="string">&quot;DELETE&quot;</span><span class="punctuation">,</span> <span class="attr">&quot;url&quot;</span><span class="punctuation">:</span> <span class="string">&quot;Observation/obs-1&quot;</span> <span class="punctuation">&#125;</span></span><br><span class="line"> <span class="punctuation">&#125;</span></span><br><span class="line"> <span class="punctuation">]</span></span><br><span class="line"><span class="punctuation">&#125;</span></span><br></pre></td></tr></table></figure>
+<p>这个 bundle 从规范层面就不合法。原因有两个:一是服务端不会按你写的顺序处理,DELETE 先于 PATCH;二是同一个资源 <code>Observation/obs-1</code> 在 transaction 里出现了两次,构成身份重叠,规范要求失败。</p>
+<p>再说 DELETE。FHIR 的 DELETE 不是物理删除。从普通读取角度看,资源返回 410 Gone;从搜索角度看,资源不再出现;但如果服务端维护版本历史,<code>_history</code> 里仍然有记录,而且删除本身会形成一个&quot;被标记为 deleted 的特殊历史版本&quot;。规范还提到被删除的资源可以通过后续 PUT update “bring back to life”。</p>
+<p>这对审计设计有直接影响。如果想把删除审计写在主资源的 extension 里(比如 deletedBy、deletedAt),就不能用一个 transaction 搞定,因为同一个资源不能既 PATCH 又 DELETE。你得接受两步法:先更新资源写审计信息,再执行 DELETE。代价是多出一个预删除版本,但好处是审计信息确实留在了主资源历史里。</p>
+<p>什么时候该用 transaction?比如多资源必须原子操作的场景,资源间存在内部引用的场景,希望服务端负责一致性边界的场景。</p>
+<p>什么时候不该用?比如只是想减少 HTTP 请求次数的,用 batch;bundle 太大事务太重的,某些资源本来就适合异步处理的。</p>
+<h2 id="参考资料"><a class="header-anchor" href="#参考资料">¶</a>参考资料</h2>
+<ul>
+<li>FHIR R4 RESTful API<br>
+<a target="_blank" rel="noopener" href="https://hl7.org/fhir/R4/http.html">https://hl7.org/fhir/R4/http.html</a></li>
+<li>FHIR R4 Transaction Processing Rules<br>
+<a target="_blank" rel="noopener" href="https://hl7.org/fhir/R4/http.html#transaction">https://hl7.org/fhir/R4/http.html#transaction</a></li>
+<li>FHIR R4 Delete Interaction<br>
+<a target="_blank" rel="noopener" href="https://hl7.org/fhir/R4/http.html#delete">https://hl7.org/fhir/R4/http.html#delete</a></li>
+<li>Medplum: FHIR Batch Requests<br>
+<a target="_blank" rel="noopener" href="https://www.medplum.com/docs/fhir-datastore/fhir-batch-requests">https://www.medplum.com/docs/fhir-datastore/fhir-batch-requests</a></li>
+</ul>
+
+</div>
+
+<script>
+ window.onload = detectors();
+</script>
+ <div class="post-footer">
+ <div class="h-line-primary"></div>
+ <nav class="post-nav">
+ <div class="prev-item">
+
+ <div class="icon arrow-left"></div>
+ <div class="post-link">
+ <a href="/2026/03/16/Nginx-%E5%89%8D%E5%90%8E%E7%AB%AF%E5%90%8C%E5%9F%9F%E5%88%86%E6%B5%81/">Prev</a>
+ </div>
+
+ </div>
+ <div class="next-item">
+
+ <div class="icon arrow-right"></div>
+ <div class="post-link">
+ <a href="/2026/03/06/Tacrolimus-for-Stasis-Dermatitis-in-Palliative-Heart-Failure-and-COPD/">Next</a>
+ </div>
+
+ </div>
+ </nav>
+</div>
+
+
+ <div class="post-comment">
+
+
+
+
+
+
+
+</div>
+
+
+</article>
+ </div>
+ </div>
+
+ <div class="footer">
+ <div class="flex-container">
+ <div class="footer-text">
+
+
+ 韩暮秋 |
+
+
+ 希望路过的人可以添点柴火让这里暖和点
+
+ </div>
+ </div>
+</div>
+
+
+ </div>
+
+ <script src="/js/mermaid-zoom.js"></script>
+
+ </body>
+</html>
diff --git a/2026/03/16/Nginx-前后端同域分流/index.html b/2026/03/16/Nginx-前后端同域分流/index.html
new file mode 100644
index 00000000..8b63c3c4
--- /dev/null
+++ b/2026/03/16/Nginx-前后端同域分流/index.html
@@ -0,0 +1,266 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
+<meta http-equiv="X-UA-Compatible" content="ie=edge">
+
+ <meta name="author" content="韩暮秋">
+
+
+ <meta name="subtitle" content="暮秋小屋">
+
+
+ <meta name="description" content="这里是暮秋小屋,思念和灵感的寄存处">
+
+
+ <meta name="keywords" content="韩暮秋,MuqiuHan,'Muqiu Han', 'muqiu han', muqiuhan">
+
+
+
+
+ <title>
+
+ Nginx 前后端同域分流 |
+ 暮秋小屋
+ </title>
+
+
+
+ <link rel="icon" href="/favicon.ico">
+
+
+
+
+ <!-- stylesheets list from _config.yml -->
+
+ <link rel="stylesheet" href="/css/style.css">
+
+
+
+
+ <link rel="preload" href="/fonts/latin-base.woff2" as="font" type="font/woff2" crossorigin>
+ <link rel="preload" href="/fonts/cjk-common.woff2" as="font" type="font/woff2" crossorigin>
+
+
+
+ <!-- scripts list from _config.yml -->
+
+ <script
+ src="/js/menu.js"></script>
+
+
+
+
+
+ <script
+ src="https://polyfill.alicdn.com/polyfill.js?features=es6"></script>
+ <script
+ id="MathJax-script"
+ async
+ src="https://lf6-cdn-tos.bytecdntp.com/cdn/expire-1-M/mathjax/3.2.0/es5/tex-mml-chtml.js"></script>
+
+
+
+
+ <meta name="generator" content="Hexo 6.3.0"></head>
+ <body>
+ <div class="wrapper">
+
+ <div class="header">
+ <div class="flex-container">
+ <div class="header-inner">
+ <div class="site-brand-container">
+ <a href="/">
+
+ 暮秋小屋
+
+ </a>
+ </div>
+ <div id="menu-btn" class="menu-btn" onclick="toggleMenu()">
+ 菜单
+ </div>
+ <nav class="site-nav">
+ <ul class="menu-list">
+
+
+ <li class="menu-item">
+ <a href="/">
+ 主页
+ </a>
+ </li>
+
+
+
+ <li class="menu-item">
+ <a href="/categories/gallery/">
+ 日记本
+ </a>
+ </li>
+
+
+
+ <li class="menu-item">
+ <a href="/tags/Medicine/">
+ 泛医学
+ </a>
+ </li>
+
+
+
+ <li class="menu-item">
+ <a href="/tags/Technique/">
+ 计算机
+ </a>
+ </li>
+
+
+
+ <li class="menu-item">
+ <a href="/tags/Life/">
+ 生活
+ </a>
+ </li>
+
+
+
+ <li class="menu-item">
+ <a href="/archives">
+ 全部
+ </a>
+ </li>
+
+
+
+ <li class="menu-item">
+ <a href="/about">
+ 关于
+ </a>
+ </li>
+
+
+
+ <li class="menu-item">
+ <a href="/search">搜索</a>
+ </li>
+
+ </ul>
+ </nav>
+ </div>
+ </div>
+</div>
+
+
+ <div class="main">
+ <div class="flex-container">
+ <article id="post">
+
+
+ <div class="post-head">
+ <div class="post-info">
+ <div class="tag-list">
+
+
+ <span class="post-tag">
+ <a href="/tags/Technique/">
+ Technique
+ </a>
+ </span>
+
+
+ </div>
+ <div class="post-title">
+
+
+ Nginx 前后端同域分流
+
+
+ </div>
+ <span class="post-date">
+ Mar 16, 2026
+ </span>
+ </div>
+ <div class="post-img">
+
+ <div class="h-line-primary"></div>
+
+ </div>
+</div>
+ <div class="post-content">
+ <p>今天我想在服务器上的 docker nginx 中配置:同一主域下,前端走 <code>/</code>,后端 API 走 <code>/api/*</code>,认证框架 Better Auth 走 <code>/api/auth/*</code>。后端还有自己的 <code>/auth/*</code> 业务接口。</p>
+<p>例如 xxx.yyy.zzz 是前端,xxx.yyy.zzz/api 是后端,后端基于 NestJS 用了 better-auth 会自动挂 /auth 路径。</p>
+<p>Nginx 跑在 Docker 容器里,配置和证书从宿主机挂载进去:</p>
+<ul>
+<li><code>/opt/nginx/conf.d</code> → <code>/etc/nginx/conf.d</code></li>
+<li><code>/opt/nginx/ssl</code> → <code>/etc/nginx/ssl</code></li>
+<li><code>/opt/nginx/nginx.conf</code> → <code>/etc/nginx/nginx.conf</code></li>
+</ul>
+<p>容器通过 <code>extra_hosts: host.docker.internal:host-gateway</code> 访问宿主机服务,所以前后端进程可以继续跑在宿主机上(比如 PM2 管理),Nginx 容器只做反代。</p>
+<p>遇到的第一个坑:<code>/api/auth/*</code> 和 <code>/api/*</code> 不能用同一个 rewrite 规则。</p>
+<p>如果这么写:</p>
+<figure class="highlight nginx"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><span class="section">location</span> /api/ &#123;</span><br><span class="line"> <span class="attribute">proxy_pass</span> http://host.docker.internal:&lt;backend&gt;/;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure>
+<p>Nginx 会把 <code>/api</code> 前缀裁掉。于是 <code>/api/auth/sign-in/email</code> 变成了 <code>/auth/sign-in/email</code>,但 better-auth 挂在 <code>/api/auth/*</code>,直接 404。</p>
+<p>正确的做法是分开处理。更麻烦的是业务身份接口 <code>/auth/me</code> 也存在,如果后端业务接口是 <code>/auth/me</code>,而认证框架是 <code>/api/auth/*</code>,那 <code>/api/auth/me</code> 应该转发给业务而不是认证框架。</p>
+<p>正确顺序:</p>
+<figure class="highlight nginx"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br></pre></td><td class="code"><pre><span class="line"><span class="section">location</span> = /api/auth/me &#123;</span><br><span class="line"> <span class="comment"># 精确匹配,业务身份接口</span></span><br><span class="line"> <span class="attribute">rewrite</span><span class="regexp"> ^/api(.*)$</span> <span class="variable">$1</span> <span class="literal">break</span>;</span><br><span class="line"> <span class="attribute">proxy_pass</span> http://host.docker.internal:&lt;backend&gt;;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="section">location</span><span class="regexp"> ^~</span> /api/auth/ &#123;</span><br><span class="line"> <span class="comment"># 认证框架路由,保留前缀</span></span><br><span class="line"> <span class="attribute">proxy_pass</span> http://host.docker.internal:&lt;auth-port&gt;;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="section">location</span><span class="regexp"> ^~</span> /api/ &#123;</span><br><span class="line"> <span class="comment"># 其余 API,裁掉 /api</span></span><br><span class="line"> <span class="attribute">rewrite</span><span class="regexp"> ^/api(.*)$</span> <span class="variable">$1</span> <span class="literal">break</span>;</span><br><span class="line"> <span class="attribute">proxy_pass</span> http://host.docker.internal:&lt;backend&gt;;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="section">location</span> / &#123;</span><br><span class="line"> <span class="comment"># 前端</span></span><br><span class="line"> <span class="attribute">proxy_pass</span> http://host.docker.internal:&lt;frontend&gt;;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure>
+<p>这里的顺序很重要。Nginx 匹配规则是:精确匹配 <code>=</code> 优先,然后是前缀匹配 <code>^~</code>,然后是正则匹配,最后是普通前缀匹配。<code>^~</code> 表示一旦匹配成功就不再检查正则。</p>
+
+</div>
+
+<script>
+ window.onload = detectors();
+</script>
+ <div class="post-footer">
+ <div class="h-line-primary"></div>
+ <nav class="post-nav">
+ <div class="prev-item">
+
+ </div>
+ <div class="next-item">
+
+ <div class="icon arrow-right"></div>
+ <div class="post-link">
+ <a href="/2026/03/12/%E7%AE%80%E5%8D%95%E8%AF%B4%E8%AF%B4-FHIR-Transaction-Bundle/">Next</a>
+ </div>
+
+ </div>
+ </nav>
+</div>
+
+
+ <div class="post-comment">
+
+
+
+
+
+
+
+</div>
+
+
+</article>
+ </div>
+ </div>
+
+ <div class="footer">
+ <div class="flex-container">
+ <div class="footer-text">
+
+
+ 韩暮秋 |
+
+
+ 希望路过的人可以添点柴火让这里暖和点
+
+ </div>
+ </div>
+</div>
+
+
+ </div>
+
+ <script src="/js/mermaid-zoom.js"></script>
+
+ </body>
+</html>