<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
    <channel>
        <title>Emfor on Embark Systems</title>
        <link>https://embark.systems/tags/emfor/</link>
        <description>Recent content in Emfor on Embark Systems</description>
        <generator>Hugo -- gohugo.io</generator>
        <language>zh-hant-tw</language>
        <lastBuildDate>Tue, 17 Nov 2026 07:00:00 +0800</lastBuildDate><atom:link href="https://embark.systems/tags/emfor/index.xml" rel="self" type="application/rss+xml" /><item>
            <title>emfor 0.6.0：部署時把 backend 排出去、設定拆成多個檔案，以及接上你已經在用的工具</title>
            <link>https://embark.systems/posts/emfor-0.6.0/</link>
            <pubDate>Tue, 17 Nov 2026 07:00:00 +0800</pubDate>
            <guid>https://embark.systems/posts/emfor-0.6.0/</guid>
            <description>&lt;img src=&#34;https://embark.systems/images/emfor-0.6.0.zh.png&#34; alt=&#34;Featured image of post emfor 0.6.0：部署時把 backend 排出去、設定拆成多個檔案，以及接上你已經在用的工具&#34; /&gt;&lt;p&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/embark-systems/emfor&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;emfor&lt;/a&gt; 是一個開源、跑在每一台應用程式主機上的健康檢查 daemon：它檢查應用程式所用服務的 backend，把哪些 backend 健康寫進本機的檔案，應用程式透過 client 函式庫在大約一微秒內查到該連哪一台，不經過網路。&lt;/p&gt;&#xA;&lt;p&gt;0.6.0 在 2026-11-17 發佈。0.5.0 談的是 daemon 周圍出狀況時會怎樣；這一版談的是&lt;strong&gt;和你已經有的東西一起用&lt;/strong&gt;：部署時把 backend 拿出來、把設定拆成多個檔案、問 emfor 應用程式會拿到什麼以及為什麼，並把它的 DNS 答案接到 nginx、HAProxy、Caddy、Prometheus、pf，以及自己查 SRV 記錄的 client。這一版也提供 deb 與 rpm 套件，手冊多了一章給從 HAProxy 或 Consul 搬過來的人。&lt;/p&gt;&#xA;&lt;h2 id=&#34;一升級前先看&#34;&gt;一、升級前先看&#xA;&lt;/h2&gt;&lt;p&gt;store 格式（版本 2）與 plugin 協定（1）沒有改：0.5.0 的 client 與 plugin 仍能搭配這一版的 daemon，0.5.0 接受的設定也仍然接受。仍有三件事可能影響現有環境：&lt;/p&gt;&#xA;&lt;ol&gt;&#xA;&lt;li&gt;&lt;strong&gt;要用 &lt;code&gt;drain = true&lt;/code&gt;，請先升級 &lt;code&gt;libemfor&lt;/code&gt; 與各 client。&lt;/strong&gt; 被 drain 的 backend 在 store 裡寫成 &lt;code&gt;unhealthy&lt;/code&gt;，舊 client 會像對待任何不健康的 backend 一樣略過它。例外是 &lt;code&gt;open&lt;/code&gt; 服務在全部 backend 都掛掉時的最後一層：那裡舊 client 仍可能選到它。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;[peers]&lt;/code&gt; 的 &lt;code&gt;secret_file&lt;/code&gt; 如果群組或其他人可寫，現在會被拒絕&lt;/strong&gt;，含密碼的檔案本來就該如此。有這種檔案的群組，升級後會載入不了設定：&lt;code&gt;emfor check-config&lt;/code&gt; 會先發現。（新的 &lt;code&gt;include_dir&lt;/code&gt; 裡的檔案同樣不可讓群組或其他人寫入，擁有者也必須是 root 或執行 emfor 的使用者；請用那個使用者執行 &lt;code&gt;emfor check-config&lt;/code&gt;。）&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;libemfor&lt;/code&gt; 改名為 0.6&lt;/strong&gt;（&lt;code&gt;libemfor.so.0.6&lt;/code&gt;），FreeBSD 的範例 port 也從 &lt;code&gt;examples/freebsd/&lt;/code&gt; 搬到 &lt;code&gt;packages/freebsd/&lt;/code&gt;（檔案相同）：有連結或腳本寫著舊路徑的要更新。&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;h2 id=&#34;二drain--true部署時把-backend-拿出來&#34;&gt;二、&lt;code&gt;drain = true&lt;/code&gt;：部署時把 backend 拿出來&#xA;&lt;/h2&gt;&lt;p&gt;backend 的表可以設 &lt;code&gt;drain = true&lt;/code&gt;。reload 之後，這個 backend 不會被任何選擇方式選到：沒有 &lt;code&gt;balance&lt;/code&gt; 方法會選它（含 &lt;code&gt;sticky&lt;/code&gt; 與 &lt;code&gt;failover&lt;/code&gt;），DNS 的 A、AAAA 與 SRV 答案裡沒有它，&lt;code&gt;fastest&lt;/code&gt; 的池裡也沒有。它的檢查照常進行，所以 &lt;code&gt;emfor status&lt;/code&gt; 顯示 &lt;code&gt;drained (checks: healthy)&lt;/code&gt;，拿掉 &lt;code&gt;drain&lt;/code&gt; 後它立刻回來，狀態就是檢查給的，不必重新數 &lt;code&gt;rise&lt;/code&gt;。&lt;code&gt;emfor lookup --explain&lt;/code&gt; 把它列為 &lt;code&gt;drained&lt;/code&gt;，指標 &lt;code&gt;emfor_backend_drain&lt;/code&gt; 對它是 1。&lt;/p&gt;&#xA;&lt;p&gt;一個服務的 backend 全部被 drain 時，lookup 會失敗並回 &lt;code&gt;ALL_DOWN&lt;/code&gt;，DNS 回 &lt;code&gt;SERVFAIL&lt;/code&gt;，不論是否 &lt;code&gt;open&lt;/code&gt;。&lt;code&gt;drain&lt;/code&gt; 屬於這台主機：不會傳給其他成員，也不算進成員之間比對的服務定義。沒有執行期的指令：改設定檔再 reload。&lt;/p&gt;&#xA;&lt;p&gt;手冊第 8 章有一個圍繞它的滾動部署食譜，&lt;code&gt;examples/deploy/emfor-drain.sh&lt;/code&gt; 做一台 backend 的這幾步：在 &lt;code&gt;conf.d&lt;/code&gt; 的檔案裡設 &lt;code&gt;drain&lt;/code&gt;、檢查設定、reload、等到 emfor 顯示它被 drain，之後等它的檢查通過才放回去。前面是 nginx 時，drain 之後進行中的請求會做完，直接停掉則會被切斷。&lt;code&gt;wait-ready&lt;/code&gt; 不相信第一個 &lt;code&gt;healthy&lt;/code&gt;：剛停掉的 backend 會維持那個狀態 &lt;code&gt;fall&lt;/code&gt; x &lt;code&gt;interval&lt;/code&gt;（預設 6 秒），所以它要等一次比指令更新的檢查，並且連續 10 秒都是 &lt;code&gt;healthy&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;h2 id=&#34;三設定拆成多個檔案與-check-config---show&#34;&gt;三、設定拆成多個檔案，與 &lt;code&gt;check-config --show&lt;/code&gt;&#xA;&lt;/h2&gt;&lt;p&gt;在 &lt;code&gt;emfor.toml&lt;/code&gt; 裡寫 &lt;code&gt;include_dir = &amp;quot;conf.d&amp;quot;&lt;/code&gt;，daemon 會先讀主設定檔，再依檔名順序讀該目錄裡每個 &lt;code&gt;*.toml&lt;/code&gt; 檔（位元組順序：請寫 &lt;code&gt;01-&lt;/code&gt;、&lt;code&gt;10-&lt;/code&gt;、&lt;code&gt;99-&lt;/code&gt;），後面的檔案蓋掉前面的。表是一個鍵一個鍵合併；其他東西，包括 &lt;code&gt;backends&lt;/code&gt; 這種清單，整個被後面的值取代。後面的檔案不能刪掉前面定義的服務或 backend。&lt;code&gt;[store]&lt;/code&gt; 與 &lt;code&gt;include_dir&lt;/code&gt; 只在主設定檔有效，因為 &lt;code&gt;emfor status&lt;/code&gt; 與 &lt;code&gt;emfor lookup&lt;/code&gt; 只讀那個檔。&lt;/p&gt;&#xA;&lt;p&gt;目錄必須存在，否則設定被拒絕（啟動時 daemon 以 2 結束；reload 時保留舊設定）。錯誤訊息會帶出檔名，&lt;code&gt;emfor check-config&lt;/code&gt; 會列出它讀過的檔案，daemon 在啟動與 reload 時把清單寫進 log。下面的套件附的設定只有 &lt;code&gt;include_dir = &amp;quot;conf.d&amp;quot;&lt;/code&gt;，加上一個空目錄。&lt;/p&gt;&#xA;&lt;p&gt;&lt;code&gt;emfor check-config --show&lt;/code&gt; 和以前一樣檢查設定，並把合併後的設定以 TOML 印到標準輸出，每個值後面加 &lt;code&gt;# &amp;lt;檔案&amp;gt;&lt;/code&gt;，是最後設定它的那個檔。內建預設值不會補上，也不遮蔽任何東西。這個註解格式給人看，不是給腳本用；不加 &lt;code&gt;--show&lt;/code&gt; 時沒有任何改變。&lt;/p&gt;&#xA;&lt;h2 id=&#34;四emfor-lookup與更清楚的-emfor-status&#34;&gt;四、&lt;code&gt;emfor lookup&lt;/code&gt;，與更清楚的 &lt;code&gt;emfor status&lt;/code&gt;&#xA;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;emfor lookup &amp;lt;服務&amp;gt; [--key &amp;lt;k&amp;gt;] [--explain] [--json] [--dns A|AAAA]&lt;/code&gt; 印出 client 函式庫會給的 backend，給沒有 client 的 shell 腳本與 cron 用。&lt;code&gt;--explain&lt;/code&gt; 顯示 store 是否過期、候選來自哪一層、其他每個 backend 被排除的原因（&lt;code&gt;unhealthy&lt;/code&gt;、&lt;code&gt;unknown&lt;/code&gt;、&lt;code&gt;last check failed&lt;/code&gt;、&lt;code&gt;backup held back&lt;/code&gt;、&lt;code&gt;not in the pool&lt;/code&gt;、&lt;code&gt;not at this site&lt;/code&gt;、&lt;code&gt;stale&lt;/code&gt;）、slow start 的步驟，以及 &lt;code&gt;balance&lt;/code&gt; 怎麼選，而且不會推進任何輪替。&lt;code&gt;--dns A|AAAA&lt;/code&gt; 從 store 說明 DNS 伺服器的答案。&lt;code&gt;--json&lt;/code&gt; 只會增加欄位；結束碼 0 是有答案、1 沒有 backend、2 沒有這個服務或用法錯誤、3 store 不能用。&lt;/p&gt;&#xA;&lt;p&gt;&lt;code&gt;emfor status&lt;/code&gt; 的文字輸出現在會標出 &lt;code&gt;backup&lt;/code&gt; backend，標出仍是 &lt;code&gt;healthy&lt;/code&gt; 但最近一次檢查失敗的 backend（&lt;code&gt;last check failed&lt;/code&gt;，lookup 通常會略過它），而且當群組的存活成員少於三個時，&lt;code&gt;peers:&lt;/code&gt; 那一行會寫 &lt;code&gt;too few live members to vote&lt;/code&gt;，表示每個原因都只是這台主機自己的。&lt;/p&gt;&#xA;&lt;h2 id=&#34;五接上你已經在用的工具的食譜&#34;&gt;五、接上你已經在用的工具的食譜&#xA;&lt;/h2&gt;&lt;p&gt;手冊第 7 章現在分成兩章：DNS 參考，與第 7b 章的食譜。每個食譜都有一支測試腳本，在容器裡對真正的程式跑（&lt;code&gt;tests/&amp;lt;名稱&amp;gt;/run.sh&lt;/code&gt;）；Integrations workflow 每週跑其中大部分，pf 那支則是在 FreeBSD 上手動跑過。測試找到、手冊現在寫明的事：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;nginx&lt;/strong&gt;（1.27.3 或更新）：&lt;code&gt;server api.svc.emfor service=http resolve;&lt;/code&gt; 配 &lt;code&gt;resolver 127.0.0.1:5300&lt;/code&gt;，從 emfor 的 SRV 答案取得 upstream；健康狀態、&lt;code&gt;drain&lt;/code&gt; 與權重在幾秒內送到，不必 reload。&lt;code&gt;stream&lt;/code&gt; 也能用。查詢失敗之後，nginx 要等 &lt;code&gt;resolver_timeout&lt;/code&gt; 才會再問，預設 30 秒，所以食譜設 &lt;code&gt;resolver_timeout 1s&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;HAProxy&lt;/strong&gt;：用 &lt;code&gt;server-template&lt;/code&gt; 從 SRV 答案填入 server。HAProxy 會忽略 SRV 的&lt;strong&gt;優先順序與權重&lt;/strong&gt;，所以 &lt;code&gt;failover&lt;/code&gt;、&lt;code&gt;weighted&lt;/code&gt;、&lt;code&gt;locality&lt;/code&gt; 與 &lt;code&gt;fastest&lt;/code&gt; 的表現和 nginx 不同；&lt;code&gt;SERVFAIL&lt;/code&gt; 之後它會在 &lt;code&gt;hold other&lt;/code&gt;（30 秒）後丟掉 server，nginx 則保留最後一份清單；對 backend 用 TLS 時要設 &lt;code&gt;sni&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;Caddy&lt;/strong&gt;：&lt;code&gt;reverse_proxy&lt;/code&gt; 搭配 &lt;code&gt;dynamic srv&lt;/code&gt;。&lt;code&gt;dynamic srv&lt;/code&gt; 與 &lt;code&gt;transport http&lt;/code&gt; 兩處都要 &lt;code&gt;resolvers&lt;/code&gt;，還要 &lt;code&gt;grace_period&lt;/code&gt;（沒有它，emfor 回 &lt;code&gt;SERVFAIL&lt;/code&gt; 時每個請求都失敗）與 &lt;code&gt;lb_try_duration&lt;/code&gt;（沒有它，剛停掉的 backend 會掉請求）；只有 &lt;code&gt;lb_policy first&lt;/code&gt; 才依優先順序。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;Prometheus&lt;/strong&gt;：&lt;code&gt;dns_sd_configs&lt;/code&gt; 的 &lt;code&gt;SRV&lt;/code&gt; 類型把健康的 backend 變成抓取目標。檢查失敗的 backend 不再是目標，所以它的 &lt;code&gt;up&lt;/code&gt; 序列直接結束，&lt;code&gt;up == 0&lt;/code&gt; 永遠不會觸發：請改用 emfor 自己的指標告警。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;pf（FreeBSD）&lt;/strong&gt;：&lt;code&gt;examples/pf/emfor-pf-table.sh&lt;/code&gt; 讓 pf 的 table 等於優先順序最低的 SRV 目標，於是一條 &lt;code&gt;rdr&lt;/code&gt; 規則就把連線分散到 emfor 提供的 backend，不需要 proxy。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;自己查 SRV 記錄的 client&lt;/strong&gt;：MIT Kerberos（&lt;code&gt;dns_lookup_kdc&lt;/code&gt;）、OpenLDAP（&lt;code&gt;ldapsearch -H &#39;ldap:///dc=ldap%2Cdc=svc%2Cdc=emfor&#39;&lt;/code&gt;，逗號必須寫成 &lt;code&gt;%2C&lt;/code&gt;）與 PyMongo（&lt;code&gt;mongodb+srv://&lt;/code&gt;）透過 emfor 找到伺服器，並避開檢查失敗或被 drain 的伺服器。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;Nagios、Icinga 與 Zabbix&lt;/strong&gt;：&lt;code&gt;examples/nagios/check_emfor.sh&lt;/code&gt; 把 &lt;code&gt;emfor status --json&lt;/code&gt; 報告的內容轉成 Nagios 狀態，&lt;code&gt;examples/nagios/emfor-exec.sh&lt;/code&gt; 則把現成的 Nagios plugin 當成 &lt;code&gt;exec&lt;/code&gt; 檢查來跑。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;每一節結尾都寫了沒試過什麼（真正的 KDC、LDAP 與 MongoDB 伺服器、nginx Plus、HTTPS upstream 等）；採用某個食譜之前請先讀那一段。第 10 章是新的：它把 HAProxy 的 backend 與帶 HTTP 檢查的 Consul 服務，一個選項一個選項地翻成 &lt;code&gt;emfor.toml&lt;/code&gt;，說明哪些沒有對應（最少連線、重試、被動檢查、註冊），並說明怎麼在現有環境旁邊試用 emfor。&lt;/p&gt;&#xA;&lt;h2 id=&#34;六deb-與-rpm-套件&#34;&gt;六、deb 與 rpm 套件&#xA;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;packages/build.sh&lt;/code&gt; 在一個用舊 glibc 的容器裡建出 deb 與 rpm（Debian 11 以後、Ubuntu 20.04 以後、RHEL 9 及相近的發行版）：&lt;code&gt;/usr/bin&lt;/code&gt; 下的 &lt;code&gt;emfor&lt;/code&gt; 與 &lt;code&gt;emfor-check&lt;/code&gt;、systemd unit、範例設定，以及 &lt;code&gt;emfor&lt;/code&gt; 使用者（deb 會啟用並啟動服務，rpm 不會）。它們由這個 repository 建出，沒有發佈，也沒有簽章。它們依賴 &lt;code&gt;ca-certificates&lt;/code&gt;：http 檢查即使 &lt;code&gt;scheme = &amp;quot;http&amp;quot;&lt;/code&gt; 也用系統的根憑證建 client，沒有就會失敗。&lt;/p&gt;&#xA;&lt;h2 id=&#34;七全系統審查的修正&#34;&gt;七、全系統審查的修正&#xA;&lt;/h2&gt;&lt;p&gt;對整個系統對照程式碼與測試所做的審查，找到並修正了：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;reload 或結束時，被取消的 plugin 請求不再算成「沒有答案」，所以由多個服務共用的健康 plugin，不會在其中一個服務被 reload 掉時被殺掉重啟；&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;emfor check-config&lt;/code&gt; 與 &lt;code&gt;emfor lookup&lt;/code&gt; 遇到寫入標準輸出的錯誤，會回報錯誤與結束碼，不再 panic；管線被關掉不算錯誤；&lt;/li&gt;&#xA;&lt;li&gt;plugin 的 &lt;code&gt;validate&lt;/code&gt; 答案有大小上限，被拒絕的 reload 不會讓 daemon 殺掉正在跑的 plugin；&lt;/li&gt;&#xA;&lt;li&gt;聯防群組訊息裡的 &lt;code&gt;boot&lt;/code&gt; 必須是規格所寫的小寫十六進位；成員的 &lt;code&gt;down&lt;/code&gt; 原因在寫進 log 前會被截短並跳脫；DNS 的速率限制在表滿時每秒清一次，不再每個封包清一次。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;手冊第 7、8、10 章中，說得比測試所能證明的更多的地方也已更正。刻意不改的：RADIUS 的 &lt;code&gt;secret_file&lt;/code&gt;、&lt;code&gt;password_file&lt;/code&gt; 與 &lt;code&gt;tls_key_file&lt;/code&gt; 仍然沒有權限檢查，因為加上去會讓目前能跑的安裝起不來。&lt;/p&gt;&#xA;&lt;h2 id=&#34;八已知限制&#34;&gt;八、已知限制&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;FreeBSD 只在 15.1-RELEASE（arm64，VM）測過：測試、rc.d 腳本、用 &lt;code&gt;make stage check-plist&lt;/code&gt; 檢查的 port、fork 測試，以及手動跑過的 nginx、HAProxy 與 pf 食譜。沒測：poudriere、13.x、14.x、amd64。&lt;/li&gt;&#xA;&lt;li&gt;HAProxy 3.4.4 在 FreeBSD 上，&lt;code&gt;server-template&lt;/code&gt; 的某個位置曾出現「位址對、port 為 0」，之後有一段時間回 503，只用一個 name server 時也會；原因不明，同一個測試在 Linux 上通過。&lt;/li&gt;&#xA;&lt;li&gt;deb 與 rpm 在沒有 systemd 的容器（arm64）裡安裝、升級與移除過（deb 也在 systemd 下試過）；沒在 x86-64 上測，rpm 也沒在 systemd 下測，且沒有簽章、沒有發佈。&lt;/li&gt;&#xA;&lt;li&gt;與先前版本相同：聯防群組的訊息沒有 forward secrecy；&lt;code&gt;ldap&lt;/code&gt; plugin 只對 Active Directory 檢查過，而且沒有憑證；Linux 上跨執行緒的 lookup 吞吐量在每秒約兩百萬次時趨平；&lt;code&gt;[store] sync = false&lt;/code&gt;（預設）時，主機當機可能損壞 store；一台主機最多對聯防群組宣告 80 個被排除的服務。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;九怎麼升級&#34;&gt;九、怎麼升級&#xA;&lt;/h2&gt;&lt;ol&gt;&#xA;&lt;li&gt;升級前，用 daemon 的使用者與 0.6.0 的二進位檔，對每台主機的設定跑 &lt;code&gt;emfor check-config&lt;/code&gt;（見第一節）。&lt;/li&gt;&#xA;&lt;li&gt;一台一台安裝 0.6.0 的 &lt;code&gt;libemfor&lt;/code&gt; 與 daemon；打算用 &lt;code&gt;drain = true&lt;/code&gt; 的話，先升級 client。&lt;/li&gt;&#xA;&lt;li&gt;要用新東西：加上 &lt;code&gt;include_dir&lt;/code&gt; 並把服務搬進檔案、在一台主機上試 &lt;code&gt;emfor lookup --explain&lt;/code&gt;，再讀第 7b 章裡你用的 proxy 或工具。&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;p&gt;本站的&lt;a class=&#34;link&#34; href=&#34;https://embark.systems/emfor/&#34; &gt;使用者手冊&lt;/a&gt;已更新到 0.6.0。完整的變更清單在 &lt;a class=&#34;link&#34; href=&#34;https://github.com/embark-systems/emfor/blob/v0.6.0/CHANGELOG.md&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;CHANGELOG&lt;/a&gt;，原始碼與發佈在 &lt;a class=&#34;link&#34; href=&#34;https://github.com/embark-systems/emfor/releases/tag/v0.6.0&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;GitHub 的 v0.6.0 release&lt;/a&gt;。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h3 id=&#34;-技術合作與架構諮詢&#34;&gt;💡 技術合作與架構諮詢&#xA;&lt;/h3&gt;&lt;p&gt;您的服務是否也面臨健康檢查不一致、故障發現太慢，或檢查流量壓垮 backend 的問題？&#xA;我們能協助您評估架構、導入合適的健康檢查與服務發現機制。&lt;/p&gt;&#xA;&lt;p&gt;🌐 &lt;a class=&#34;link&#34; href=&#34;https://embark.systems/use_cases/&#34; &gt;瀏覽技術實作案例&lt;/a&gt; ｜ 📧 &lt;a class=&#34;link&#34; href=&#34;mailto:service@embark.systems&#34; &gt;預約技術顧問諮詢&lt;/a&gt;&lt;/p&gt;&#xA;</description>
        </item><item>
            <title>emfor 0.5.0：第二種加密格式、更嚴格的設定檢查，以及一批穩定性修正</title>
            <link>https://embark.systems/posts/emfor-0.5.0/</link>
            <pubDate>Sun, 15 Nov 2026 15:00:00 +0800</pubDate>
            <guid>https://embark.systems/posts/emfor-0.5.0/</guid>
            <description>&lt;img src=&#34;https://embark.systems/images/emfor-0.5.0.zh.png&#34; alt=&#34;Featured image of post emfor 0.5.0：第二種加密格式、更嚴格的設定檢查，以及一批穩定性修正&#34; /&gt;&lt;p&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/embark-systems/emfor&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;emfor&lt;/a&gt; 是一個開源、跑在每一台應用程式主機上的健康檢查 daemon：它檢查應用程式所用服務的 backend，把哪些 backend 健康寫進本機的檔案，應用程式透過 client 函式庫在大約一微秒內查到該連哪一台，不經過網路。&lt;/p&gt;&#xA;&lt;p&gt;0.5.0 在 2026-11-15 發佈。0.4.0 改的是應用程式拿到哪一個 backend；這一版談的是&lt;strong&gt;周圍出狀況時會怎樣&lt;/strong&gt;：store 被斷電截短、plugin 不再回應、磁碟 commit 很慢、任何人都連得到的 DNS port、FreeBSD 上 fork 出來就卡住的子行程。另外，聯防群組多了第二種加密格式，&lt;code&gt;emfor check-config&lt;/code&gt; 也會拒絕更多一定跑不起來的選項。&lt;/p&gt;&#xA;&lt;h2 id=&#34;一升級前先看三件可能影響現有環境的事&#34;&gt;一、升級前先看：三件可能影響現有環境的事&#xA;&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;1. 0.4.0 接受的設定，現在可能被拒絕。&lt;/strong&gt; &lt;code&gt;emfor check-config&lt;/code&gt;（每次啟動與 reload 都會跑）會拒絕一些一定無法運作、0.4.0 卻放行、之後才出錯的選項。最可能遇到的：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;code&gt;interval&lt;/code&gt; 超過 &lt;code&gt;24h&lt;/code&gt;，或 &lt;code&gt;timeout&lt;/code&gt; 小於 &lt;code&gt;10ms&lt;/code&gt;；&lt;/li&gt;&#xA;&lt;li&gt;http 的 &lt;code&gt;host_header&lt;/code&gt; 不是「主機名稱加選用的 port」（含空白、路徑或 scheme），或 http 的 &lt;code&gt;path&lt;/code&gt; 含 &lt;code&gt;#&lt;/code&gt;、&lt;code&gt;\&lt;/code&gt; 或控制字元；&lt;/li&gt;&#xA;&lt;li&gt;啟用 &lt;code&gt;[dns]&lt;/code&gt; 時，服務名稱長到容不下其 backend 的 SRV 目標名稱；&lt;/li&gt;&#xA;&lt;li&gt;exec 或 plugin 的 &lt;code&gt;command&lt;/code&gt; 含 NUL，或 &lt;code&gt;ca_file&lt;/code&gt; 裡沒有任何可當 CA 的憑證；&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;emfor-check&lt;/code&gt; 方面：mysql、pgsql、amqp 的帳號或密碼含 NUL、amqp 密碼長到塞不進 AMQP 的第一個 frame、diameter 的選項清單長到一則訊息放不下、sip 的 &lt;code&gt;uri&lt;/code&gt; 或 &lt;code&gt;from&lt;/code&gt; 含 &lt;code&gt;&amp;lt;&lt;/code&gt; 或 &lt;code&gt;&amp;gt;&lt;/code&gt;、mongodb 的 &lt;code&gt;password_file&lt;/code&gt; 內容不是可印出的 ASCII。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;升級每一台主機之前，先用新的 binary 對它的設定跑 &lt;code&gt;emfor check-config&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;2. DNS 伺服器依 client 網段限制 UDP 回應數。&lt;/strong&gt; 預設每個 IPv4 /24（IPv6 /56）每秒 100 個回應（&lt;code&gt;[dns] rate_limit&lt;/code&gt;，設 &lt;code&gt;0&lt;/code&gt; 關閉）。SRV 的回應可能是查詢的許多倍大，其他主機連得到的伺服器，可能被拿來用偽造來源位址的查詢灌第三方。超過上限後，每隔一個回應會回一個空的截斷回應，讓真正的 client 改走 TCP 重試，其餘丟棄，並計入 &lt;code&gt;emfor_dns_rate_limited_total&lt;/code&gt;。loopback 的 client 與 TCP 不受限。如果轉送你的 zone 的 resolver 從同一網段每秒送超過 100 個查詢，請調高上限。啟動時，daemon 也會對每個不是 loopback 的 &lt;code&gt;[dns] listen&lt;/code&gt; 位址記一則警告。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;3. &lt;code&gt;libemfor&lt;/code&gt; 的檔名跟著 0.5&lt;/strong&gt;：&lt;code&gt;libemfor.so.0.5&lt;/code&gt; 與 &lt;code&gt;libemfor.0.5.dylib&lt;/code&gt;。和每個版本一樣，&lt;code&gt;libemfor&lt;/code&gt; 要和 daemon 裝同一版；Python 套件會先找與自己同版號的檔案。&lt;/p&gt;&#xA;&lt;p&gt;store 格式（第 2 版）與 plugin 協定（第 1 版）沒有變。&lt;/p&gt;&#xA;&lt;h2 id=&#34;二聯防群組&#34;&gt;二、聯防群組&#xA;&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;第二種加密格式 &lt;code&gt;EMP3&lt;/code&gt;。&lt;/strong&gt; 0.4.0 用 ChaCha20-Poly1305（&lt;code&gt;EMP2&lt;/code&gt;）加密聯防訊息，每則訊息用隨機的 12 位元組 nonce。同一把 secret 下，約 2^32 則訊息以內是安全的；以估計（不是量測）來說，大型群組幾天內就可能送出這麼多則，nonce 一旦重複，旁觀者就能讀取並偽造訊息。&lt;code&gt;EMP3&lt;/code&gt; 改用 XChaCha20-Poly1305，nonce 24 位元組隨機、金鑰另外衍生，實務上沒有上限。&lt;/p&gt;&#xA;&lt;p&gt;格式依每個成員分別決定。0.5.0 送出的每則 &lt;code&gt;EMP2&lt;/code&gt; 訊息，加密的內容裡都帶 &lt;code&gt;&amp;quot;emp3&amp;quot;: true&lt;/code&gt;；從某個成員收到的最新一則訊息若是 &lt;code&gt;EMP3&lt;/code&gt; 或帶這個欄位的 &lt;code&gt;EMP2&lt;/code&gt;，就改用 &lt;code&gt;EMP3&lt;/code&gt; 傳給它，否則用 &lt;code&gt;EMP2&lt;/code&gt;。所以 0.5.0 的成員彼此用 &lt;code&gt;EMP3&lt;/code&gt;、和 0.4.0 的成員用 &lt;code&gt;EMP2&lt;/code&gt;，群組可以任意順序升級或退回，不必改設定。退回 0.4.0 的主機，大約在最初一秒內會丟掉收到的 &lt;code&gt;EMP3&lt;/code&gt; 訊息。&lt;code&gt;EMP3&lt;/code&gt; 的位元組已和另一份獨立撰寫的實作核對過，那份實作本身通過 XChaCha20 草案的測試向量。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;聯防群組的其他變更：&lt;/strong&gt;&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;code&gt;[peers] accept_plaintext = false&lt;/code&gt; 會不檢查就丟掉所有未加密的 &lt;code&gt;EMP1&lt;/code&gt; 訊息，計入新的原因 &lt;code&gt;plaintext&lt;/code&gt;；成員全都加密的群組，不必再接受簽章的明文。需要 &lt;code&gt;encrypt = true&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;新增 &lt;code&gt;[peers] previous_secret_file&lt;/code&gt;：&lt;code&gt;secret_file&lt;/code&gt; 上一次更換之前的 secret。更換後 120 秒內重啟的 daemon，會像沒重啟一樣繼續用舊 secret 簽章與接受；以前，檔案還沒換的成員會把它當成 &lt;code&gt;auth&lt;/code&gt; 拒絕。&lt;/li&gt;&#xA;&lt;li&gt;第一次更換 &lt;code&gt;secret_file&lt;/code&gt; 後 60 秒內又換第二次，不再用還沒換檔的成員不認得的中間 secret 簽章一分鐘。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;投票的修正。&lt;/strong&gt; 成員會把另一個成員的最新結果保留 3 個「寄送者的 interval」，並在這段期間自己的每個檢查時間點都算一次。這裡 &lt;code&gt;interval = &amp;quot;1s&amp;quot;&lt;/code&gt;、指派的檢查者是 &lt;code&gt;&amp;quot;30s&amp;quot;&lt;/code&gt; 時，兩個檢查者各一個 &lt;code&gt;down&lt;/code&gt;，就可能讓 &lt;code&gt;fall&lt;/code&gt; 被推進約 90 次，把檢查者自己還看到健康的 backend 標成 down。現在每個結果只在一個檢查時間點計算一次。&lt;/li&gt;&#xA;&lt;li&gt;亂序到達的訊息會被接受一次，而不是當成 &lt;code&gt;replay&lt;/code&gt; 丟掉。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;三出狀況時仍然撐住&#34;&gt;三、出狀況時仍然撐住&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;store 被截短，不再以 &lt;code&gt;SIGBUS&lt;/code&gt; 結束行程。&lt;/strong&gt; store 檔案比 LMDB 記錄的短（原地被改，或尾端在斷電時遺失），啟動時會像其他損壞一樣被移到 &lt;code&gt;&amp;lt;path&amp;gt;.corrupt&lt;/code&gt;，並記一則寫著 &lt;code&gt;truncated&lt;/code&gt; 的警告。以前，為了檢查而讀取它會讓 daemon 以 &lt;code&gt;SIGBUS&lt;/code&gt; 結束，每次重啟都一樣。&lt;code&gt;emfor status&lt;/code&gt; 會印出 &lt;code&gt;cannot open store: truncated&lt;/code&gt; 並以 2 結束，client 的查詢則回 &lt;code&gt;UNAVAILABLE&lt;/code&gt;，而不是讓應用程式死掉。daemon 現在每次 commit 後，會把檔案延伸到 LMDB 記錄的長度，所以健康的 store 不會被當成截短。開著時被原地改動的 store，仍可能讓執行中的 client 出這個問題：要換掉它請用 &lt;code&gt;mv&lt;/code&gt;，不要用 &lt;code&gt;cp&lt;/code&gt; 覆蓋或 &lt;code&gt;truncate&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;不再回應的 plugin 會被重啟。&lt;/strong&gt; 以前只有結束或關閉 stdout 的 plugin 會被重啟；一個還在跑卻不回任何答案的 plugin，會讓它所有 backend 的檢查永遠是 &lt;code&gt;error&lt;/code&gt;，對它的請求也無限堆積。現在，連續 3 個請求的呼叫端都放棄、期間沒有任何答案回來，daemon 就會記錄、殺掉並重啟這個 plugin。在 &lt;code&gt;timeout_ms&lt;/code&gt; 內有回答的 plugin 不受影響。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;commit 很慢時，DNS 回答與 &lt;code&gt;/metrics&lt;/code&gt; 不再被凍結。&lt;/strong&gt; state store 等磁碟時，daemon 以前會停止套用檢查結果，DNS 因此持續回答舊的狀態。現在結果一到就套用，這段時間的變更由下一次 commit 一起寫入。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;有上限的佇列。&lt;/strong&gt; 落後超過 4096 則訊息的 peer task，會丟掉新的 &lt;code&gt;down&lt;/code&gt; 與 &lt;code&gt;result&lt;/code&gt; 訊息（計入 &lt;code&gt;emfor_peer_queue_dropped_total&lt;/code&gt;）；不再讀 stdin 的 plugin 最多累積 1024 個等待的請求，之後的檢查立刻回 &lt;code&gt;error&lt;/code&gt;，原因是 &lt;code&gt;plugin &amp;lt;name&amp;gt; busy&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;DNS。&lt;/strong&gt; TCP 最多服務 128 條連線，並關閉 5 秒內沒有查詢的連線；DNS 監聽停掉時，daemon 會記錄並以 70 結束，讓服務管理員重啟它（以前 DNS 會悄悄沒聲音）；EDNS 版本大於 0 回 BADVERS，非 IN 的 class 回 REFUSED。&lt;/li&gt;&#xA;&lt;li&gt;store 裡單一個不是 UTF-8 的 key 或 value，不再讓 daemon 卡住；改了 &lt;code&gt;interval&lt;/code&gt; 的 reload 會套用到已在等待的那一次（以前從 &lt;code&gt;10m&lt;/code&gt; 改成 &lt;code&gt;2s&lt;/code&gt;，最久要等 11 分鐘）；daemon 以更大的 &lt;code&gt;[store] map_size&lt;/code&gt; 重啟後，client 會繼續讀取。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;四emfor-check遇到行為不正常的伺服器會卡住或當掉&#34;&gt;四、emfor-check：遇到行為不正常的伺服器會卡住或當掉&#xA;&lt;/h2&gt;&lt;p&gt;我們對每個 plugin 用「回答錯誤的伺服器」做了一輪檢視，找到一批卡住與當掉的情形。現在全部都是帶原因的 &lt;code&gt;down&lt;/code&gt; 或 &lt;code&gt;error&lt;/code&gt;，並由檢查的 timeout 結束：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;code&gt;mongodb&lt;/code&gt;：要求 4294967295 次 SCRAM 迭代的伺服器，會讓一個工作執行緒忙上好幾分鐘（現在超過 1000000 就拒絕）；巢狀約 8000 層的 &lt;code&gt;hello&lt;/code&gt; 回覆會讓堆疊溢位、plugin 中止；&lt;/li&gt;&#xA;&lt;li&gt;走 TCP 或 TLS 的 &lt;code&gt;sip&lt;/code&gt;：Content-Length 接近 64 位元最大值，會讓 plugin 對同一個暫時回應以滿載 CPU 無限迴圈；&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;redis&lt;/code&gt;：超過 2 MiB 的回覆；&lt;code&gt;mysql&lt;/code&gt;：&lt;code&gt;SELECT 1&lt;/code&gt; 回 NULL 會讓檢查 panic，被 timeout 截斷的檢查每次都會漏掉一個 task 和一個 socket；&lt;/li&gt;&#xA;&lt;li&gt;超過 512 字元的原因會在送出前截短：一個 70 KB 的 redis &lt;code&gt;-ERR&lt;/code&gt; 讓回答行超過 daemon 的限制，於是每次檢查那個 backend，daemon 都重啟 plugin；&lt;/li&gt;&#xA;&lt;li&gt;panic 的檢查會回 &lt;code&gt;error&lt;/code&gt; 與 &lt;code&gt;check panicked: &amp;lt;message&amp;gt;&lt;/code&gt;，而不是沒有回答。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;&lt;code&gt;mysql&lt;/code&gt; plugin 的實機測試（&lt;code&gt;tests/plugins/mysql.sh&lt;/code&gt;）現在也對 MySQL 8.0 與 8.4 執行並通過；以前只檢查過 MariaDB。&lt;/p&gt;&#xA;&lt;h2 id=&#34;五client以及-freebsd-上的一個卡死問題&#34;&gt;五、Client，以及 FreeBSD 上的一個卡死問題&#xA;&lt;/h2&gt;&lt;p&gt;client 遇到被截短的 store 會讓查詢失敗、store 長大後會繼續讀取（見上），對存在但打不開的 store 最多每秒重試一次，並在 thread-local 解構函式裡呼叫 &lt;code&gt;emfor_lookup&lt;/code&gt; 時回傳狀態碼而不是中止。新版 daemon 寫入的 backend &lt;code&gt;state&lt;/code&gt; 或 &lt;code&gt;on_all_down&lt;/code&gt; 值，不再讓查詢以 &lt;code&gt;INCOMPATIBLE&lt;/code&gt; 失敗：未知的 state 視為 &lt;code&gt;unhealthy&lt;/code&gt;，未知的 &lt;code&gt;on_all_down&lt;/code&gt; 視為 &lt;code&gt;open&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;FreeBSD 上，fork 出的子行程可能永遠卡住。&lt;/strong&gt; 我們的 fork 測試（其他執行緒在查詢的同時 fork）在 FreeBSD 15.1（arm64）上每次都失敗：子行程會在第一次查詢永遠等待，發生在 300 次 fork 的最初幾十次之內。&lt;strong&gt;0.4.0 在那裡有同樣的卡死&lt;/strong&gt;：用同一組測試從它的 tag 建置，Rust 測試 10 次中失敗 10 次，C 測試 5 次中失敗 5 次。&lt;/p&gt;&#xA;&lt;p&gt;原因在 FreeBSD 的執行緒函式庫 libthr，不在 emfor。LMDB 把 reader mutex 放在 store 的 lock 檔裡，是 process-shared mutex；libthr 在自己的一把鎖後面查這類 mutex，而它的 &lt;code&gt;fork&lt;/code&gt; 只以讀取方式取得這把鎖，所以當時正在這類 mutex 裡的執行緒，其讀取持有會留在子行程裡，沒有人會釋放；子行程第一次使用新映射的 mutex 就會等它。在卡住的子行程上我們讀了那把鎖：一個讀者留著、一個寫者在等。libthr 在這之外還有第二個問題：父行程在另一個執行緒第一次映射 process-shared mutex 時 fork，可能死鎖。&lt;/p&gt;&#xA;&lt;p&gt;client 現在在兩處都繞過這些問題：在 FreeBSD 上讓 &lt;code&gt;fork&lt;/code&gt; 等到沒有查詢在 store 裡（&lt;code&gt;pthread_atfork&lt;/code&gt; handler），而 &lt;code&gt;libemfor&lt;/code&gt; 在那裡不能再被卸載，因為 handler 會留著。查詢吞吐量沒有變（以 1、4、8 個執行緒量測）。它不涵蓋同一行程裡其他使用 process-shared mutex 的程式、在信號處理函式裡 &lt;code&gt;fork&lt;/code&gt;（而該信號打斷了同一個執行緒的查詢），以及靜態連結 &lt;code&gt;libemfor.a&lt;/code&gt; 又會被卸載的模組。&lt;/p&gt;&#xA;&lt;p&gt;我們也寫了一個 libthr 的 patch，連同一個不用 LMDB 的小型重現程式，放在 &lt;a class=&#34;link&#34; href=&#34;https://github.com/embark-systems/emfor/blob/v0.5.0/docs/freebsd/libthr-pshared-fork.md&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;docs/freebsd/&lt;/a&gt;。我們用 15.1 的原始碼建置 libthr 兩次，未修補與修補各一：未修補時，5 次執行中每次 300 個子行程有 40 到 55 個卡住，死鎖的父行程永遠不會結束；修補後，5 次中沒有任何子行程卡住，父行程也能結束。沒有我們的繞過方式的 LMDB client，在修補過的函式庫上也能通過。我們只在 FreeBSD 15.1（arm64）上試過，也還沒有回報給 FreeBSD。&lt;/p&gt;&#xA;&lt;h2 id=&#34;六其他變更&#34;&gt;六、其他變更&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;code&gt;emfor status&lt;/code&gt;：處理被截短的 store、&lt;code&gt;emfor status | head -1&lt;/code&gt; 保留結束碼、&lt;code&gt;--watch&lt;/code&gt; 在檔案被替換時重新開啟 store，以及顯示新版 daemon 的記錄而不是失敗。&lt;/li&gt;&#xA;&lt;li&gt;範例 systemd unit 設定 &lt;code&gt;LimitNOFILE=65536&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;發佈前每個 fuzz 目標各跑 10 分鐘。0.5.0 的六個目標（plugin 回答、peer 訊息、DNS 伺服器、metrics、plugin 協定與設定；其中 DNS 是新的）共跑約 1600 萬個輸入，沒有當機。它們現在開著 overflow 檢查，並讓每個輸入在 2 MiB 的堆疊上執行，和 tokio worker 一樣，所以溢位或遞迴過深就是當機，如同在 daemon 裡。&lt;/li&gt;&#xA;&lt;li&gt;本站的&lt;a class=&#34;link&#34; href=&#34;https://embark.systems/emfor/&#34; &gt;使用手冊&lt;/a&gt;已更新到 0.5.0。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;七已知限制&#34;&gt;七、已知限制&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;FreeBSD 只測過 15.1-RELEASE（arm64，在 VM 裡）：測試、rc.d script、用 &lt;code&gt;make stage check-plist install&lt;/code&gt; 安裝 port，以及 fork 測試。沒有測過：poudriere、13.x、14.x、amd64。&lt;/li&gt;&#xA;&lt;li&gt;FreeBSD 的 fork 防護不涵蓋上面提到的情形，libthr 的 patch 也只在 15.1 上試過。&lt;/li&gt;&#xA;&lt;li&gt;聯防訊息沒有 forward secrecy：之後取得 &lt;code&gt;secret_file&lt;/code&gt; 的人，可以讀取已錄下的訊息。請定期更換 secret。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;ldap&lt;/code&gt; plugin 只對 Active Directory 在無憑證、也沒有成功登入的情況下檢查過。&lt;/li&gt;&#xA;&lt;li&gt;與先前版本相同：跨執行緒的查詢吞吐量在 Linux 上約每秒兩百萬次就趨平；&lt;code&gt;[store] sync = false&lt;/code&gt;（預設）時，主機當機可能損壞 store 並遺失狀態歷史；一台主機在聯防群組之外最多公告 80 個服務。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;八怎麼升級&#34;&gt;八、怎麼升級&#xA;&lt;/h2&gt;&lt;ol&gt;&#xA;&lt;li&gt;升級每台主機之前，先用 0.5.0 的 binary 對它的設定跑 &lt;code&gt;emfor check-config&lt;/code&gt;（第一節）。&lt;/li&gt;&#xA;&lt;li&gt;逐台主機安裝 0.5.0 的 &lt;code&gt;libemfor&lt;/code&gt; 與 daemon。0.4.0 與 0.5.0 成員混合的聯防群組可以任意順序升級，&lt;code&gt;[peers]&lt;/code&gt; 不必改。&lt;/li&gt;&#xA;&lt;li&gt;如果你的 DNS client 從同一網段送大量查詢，升級後請觀察 &lt;code&gt;emfor_dns_rate_limited_total&lt;/code&gt;；如果它在增加，就調高 &lt;code&gt;[dns] rate_limit&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;p&gt;完整的變更清單在 &lt;a class=&#34;link&#34; href=&#34;https://github.com/embark-systems/emfor/blob/v0.5.0/CHANGELOG.md&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;CHANGELOG&lt;/a&gt;，原始碼與發佈在 &lt;a class=&#34;link&#34; href=&#34;https://github.com/embark-systems/emfor/releases/tag/v0.5.0&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;GitHub 的 v0.5.0 release&lt;/a&gt;。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h3 id=&#34;-技術合作與架構諮詢&#34;&gt;💡 技術合作與架構諮詢&#xA;&lt;/h3&gt;&lt;p&gt;您的服務是否也面臨健康檢查不一致、故障發現太慢，或檢查流量壓垮 backend 的問題？&#xA;我們能協助您評估架構、導入合適的健康檢查與服務發現機制。&lt;/p&gt;&#xA;&lt;p&gt;🌐 &lt;a class=&#34;link&#34; href=&#34;https://embark.systems/use_cases/&#34; &gt;瀏覽技術實作案例&lt;/a&gt; ｜ 📧 &lt;a class=&#34;link&#34; href=&#34;mailto:service@embark.systems&#34; &gt;預約技術顧問諮詢&lt;/a&gt;&lt;/p&gt;&#xA;</description>
        </item><item>
            <title>emfor 0.4.0：備援 backend、慢啟動、加密的聯防群組與五個新 plugin</title>
            <link>https://embark.systems/posts/emfor-0.4.0/</link>
            <pubDate>Sat, 14 Nov 2026 21:30:00 +0800</pubDate>
            <guid>https://embark.systems/posts/emfor-0.4.0/</guid>
            <description>&lt;img src=&#34;https://embark.systems/images/emfor-0.4.0.zh.png&#34; alt=&#34;Featured image of post emfor 0.4.0：備援 backend、慢啟動、加密的聯防群組與五個新 plugin&#34; /&gt;&lt;p&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/embark-systems/emfor&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;emfor&lt;/a&gt; 是一個開源、跑在每一台應用程式主機上的健康檢查 daemon：它檢查應用程式所用服務的 backend，把哪些 backend 健康寫進本機的檔案，應用程式透過 client 函式庫在大約一微秒內查到該連哪一台，不經過網路。&lt;/p&gt;&#xA;&lt;p&gt;0.4.0 在 2026-11-14 發佈。這一版的重點在於&lt;strong&gt;應用程式拿到的那個位址&lt;/strong&gt;：什麼時候該用備援、剛恢復的 backend 要不要馬上接滿流量、一個 backend 開始出問題時要多快避開它。另外，聯防群組的訊息改為加密，&lt;code&gt;emfor-check&lt;/code&gt; 也多了五種協定。&lt;/p&gt;&#xA;&lt;h2 id=&#34;一升級前先看三項不相容的變更&#34;&gt;一、升級前先看：三項不相容的變更&#xA;&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;1. store 格式升到第 2 版。&lt;/strong&gt; daemon 寫入的 &lt;code&gt;meta/schema_version&lt;/code&gt; 變成 2，多了 backend 的 &lt;code&gt;backup&lt;/code&gt; 欄位。0.4.0 的 client 與 &lt;code&gt;emfor status&lt;/code&gt; 讀得懂第 1、2 版；較舊的 client 碰到第 2 版的 store，每次查詢都會回 &lt;code&gt;INCOMPATIBLE&lt;/code&gt;。所以&lt;strong&gt;先升級主機上的 client（&lt;code&gt;libemfor&lt;/code&gt; 與各語言的套件），再升級 daemon&lt;/strong&gt;。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;2. 聯防群組的訊息預設加密。&lt;/strong&gt; 還在跑 0.3.0 的成員讀不懂，會把它們當成 &lt;code&gt;malformed&lt;/code&gt; 丟掉。逐台升級時，先在每台升級的主機的 &lt;code&gt;[peers]&lt;/code&gt; 加上 &lt;code&gt;encrypt = false&lt;/code&gt;；等每個成員都升到 0.4.0，再拿掉這一行並 reload。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;3. FreeBSD：&lt;code&gt;examples/rc.d/emfor&lt;/code&gt; 拿掉了。&lt;/strong&gt; 現在只剩 port 裡的 &lt;code&gt;examples/freebsd/files/emfor.in&lt;/code&gt; 這一份 rc.d script；不透過 port 安裝的人，照手冊第 2 章把 &lt;code&gt;%%PREFIX%%&lt;/code&gt; 換掉後安裝。它的 &lt;code&gt;emfor_user&lt;/code&gt; 預設是 &lt;code&gt;emfor&lt;/code&gt;，不再是 &lt;code&gt;root&lt;/code&gt;。另外，範例 port 把 store 放在 FreeBSD 慣用的 &lt;code&gt;/var/db/emfor&lt;/code&gt;，主機上的應用程式要設 &lt;code&gt;EMFOR_STORE=/var/db/emfor/state.mdb&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;h2 id=&#34;二挑-backend更謹慎地決定要連哪一台&#34;&gt;二、挑 backend：更謹慎地決定要連哪一台&#xA;&lt;/h2&gt;&lt;h3 id=&#34;備援-backend&#34;&gt;備援 backend&#xA;&lt;/h3&gt;&lt;p&gt;backend 可以標成備援：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;services&lt;/span&gt;.&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;db.svc.emfor&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;check&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;tcp&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;balance&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;failover&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;backends&lt;/span&gt; = [&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.0.1.5:5432&amp;#34;&lt;/span&gt;,&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.0.1.6:5432&amp;#34;&lt;/span&gt;,&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  { &lt;span style=&#34;color:#a6e22e&#34;&gt;addr&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.1.1.5:5432&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color:#a6e22e&#34;&gt;backup&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;true&lt;/span&gt; },   &lt;span style=&#34;color:#75715e&#34;&gt;# 另一個機房&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;只要還有任何一台非備援的 backend 通過檢查，備援就不會被用到。挑選順序是：最近一次檢查通過的主要 backend → 最近一次檢查通過的備援 → 健康的主要 backend → 健康的備援；&lt;code&gt;balance&lt;/code&gt; 在挑出的那一組裡運作。典型用法是把另一個機房、或比較貴的 backend 設成備援。DNS 的 SRV 回答也只列出挑出的那一組。&lt;/p&gt;&#xA;&lt;h3 id=&#34;檢查一失敗就先避開&#34;&gt;檢查一失敗就先避開&#xA;&lt;/h3&gt;&lt;p&gt;一台 backend 要連續失敗 &lt;code&gt;fall&lt;/code&gt; 次才會變成 &lt;code&gt;unhealthy&lt;/code&gt;，預設大約 6 秒。在這之前它仍算健康，0.3.0 的應用程式會繼續連過去。&lt;/p&gt;&#xA;&lt;p&gt;0.4.0 的 client 與 DNS 伺服器會先避開「仍算健康、但最近一次檢查失敗」的 backend，只要還有其他健康的 backend 最近一次檢查通過。也就是說，&lt;strong&gt;backend 在第一次檢查失敗時就不再被挑中&lt;/strong&gt;，不用等到 &lt;code&gt;fall&lt;/code&gt; 次；它的狀態仍照 &lt;code&gt;rise&lt;/code&gt; / &lt;code&gt;fall&lt;/code&gt; 計算，恢復後自然回來。如果每台健康的 backend 都在失敗，就照舊全部使用，不會因此全部拒絕。&lt;/p&gt;&#xA;&lt;p&gt;&lt;code&gt;on_all_down = &amp;quot;open&amp;quot;&lt;/code&gt; 而且沒有任何健康的 backend 時，也有類似的調整：先用還沒判定、或檢查只回錯誤的 &lt;code&gt;unknown&lt;/code&gt; backend，最後才用確定失敗的 &lt;code&gt;unhealthy&lt;/code&gt; 那些。&lt;/p&gt;&#xA;&lt;h3 id=&#34;慢啟動&#34;&gt;慢啟動&#xA;&lt;/h3&gt;&lt;p&gt;剛從 &lt;code&gt;unhealthy&lt;/code&gt; 恢復的 backend，快取是冷的、連線池是空的，一下子接滿流量常常又被打掛。新的 &lt;code&gt;slow_start&lt;/code&gt; 讓它在一段時間內分 10 個階段逐步拿到完整的流量比例：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;defaults&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;slow_start&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;30s&amp;#34;&lt;/span&gt;     &lt;span style=&#34;color:#75715e&#34;&gt;# 預設 &amp;#34;0s&amp;#34;，關閉&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;它作用於 client 查詢與 DNS 的 A / AAAA 回答（&lt;code&gt;failover&lt;/code&gt; 與帶 key 的 &lt;code&gt;sticky&lt;/code&gt; 除外），以及 SRV 的權重。&lt;/p&gt;&#xA;&lt;h3 id=&#34;sticky-也看權重&#34;&gt;sticky 也看權重&#xA;&lt;/h3&gt;&lt;p&gt;&lt;code&gt;balance = &amp;quot;sticky&amp;quot;&lt;/code&gt; 帶 affinity key 時，現在會依 &lt;code&gt;weight&lt;/code&gt; 分配：權重 w 的 backend 拿到 w 份的 key。計算只用整數與 MD5，每台主機、每種語言的 client 對同一個 key 仍挑出同一台。所有權重都是 1 時結果不變；已經設了其他權重的 sticky 服務，升級 client 後會有一部分 key 換到別台，同一個服務的 client 最好一起升級。&lt;/p&gt;&#xA;&lt;h2 id=&#34;三聯防群組&#34;&gt;三、聯防群組&#xA;&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;訊息加密。&lt;/strong&gt; 0.3.0 的聯防訊息有簽章但是明文，backend 名稱、位址與錯誤原因都看得到。0.4.0 改為 &lt;code&gt;EMP2&lt;/code&gt;：以 HKDF-SHA256 從 &lt;code&gt;secret_file&lt;/code&gt; 推導金鑰、ChaCha20-Poly1305 加密，每則訊息用隨機 nonce。更換密鑰的方式和以前一樣。這個設計沒有 forward secrecy：日後拿到密鑰的人，可以解開之前錄下的訊息，所以密鑰要定期更換。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;只有非負責主機看到的故障，發現得更快。&lt;/strong&gt; 0.3.0 的已知限制是：只有某台非負責主機看得到的故障，最多要大約五個 &lt;code&gt;interval&lt;/code&gt; 加上 &lt;code&gt;fall&lt;/code&gt; 次檢查才會發現。0.4.0 的非負責主機至少每三個 &lt;code&gt;interval&lt;/code&gt; 自己檢查一次；而且當它自己的檢查失敗、但負責主機都說 up 時，會像收到其他成員的 &lt;code&gt;down&lt;/code&gt; 通知一樣，開始每 200 ms 一次、最多 &lt;code&gt;fall&lt;/code&gt; 次的快速複查。以 &lt;code&gt;interval = &amp;quot;2s&amp;quot;&lt;/code&gt;、&lt;code&gt;fall = 3&lt;/code&gt; 實測 12 次故障，這台主機判定 down 花了 0.8 到 5.8 秒，中位數 3.3 秒；0.3.0 依排程估算最長約 14 秒。代價是每個 backend 每個 &lt;code&gt;interval&lt;/code&gt; 的檢查次數，從 &lt;code&gt;3 + (N − 3) / 5&lt;/code&gt; 變成 &lt;code&gt;3 + (N − 3) / 3&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;h2 id=&#34;四emfor-check五個新-plugin&#34;&gt;四、emfor-check：五個新 plugin&#xA;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;emfor-check&lt;/code&gt; 是隨 emfor 發佈的 plugin，用來檢查需要懂協定的服務。0.4.0 新增：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;plugin&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檢查內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;smtp&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;220 greeting 與 &lt;code&gt;EHLO&lt;/code&gt;，可加 &lt;code&gt;STARTTLS&lt;/code&gt; 或 465 port 的 TLS；不登入、不寄信&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;amqp&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;AMQP 0-9-1（如 RabbitMQ）：&lt;code&gt;PLAIN&lt;/code&gt; 登入並開啟 &lt;code&gt;vhost&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;mongodb&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;MongoDB 4.4 以上的 &lt;code&gt;hello&lt;/code&gt;，可選 SCRAM-SHA-256 登入；&lt;code&gt;role = &amp;quot;primary&amp;quot;&lt;/code&gt; 讓 &lt;code&gt;failover&lt;/code&gt; 跟著 replica set 的 primary 走&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;grpc&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;標準 &lt;code&gt;grpc.health.v1.Health/Check&lt;/code&gt;，回 &lt;code&gt;SERVING&lt;/code&gt; 才算 up&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;quic&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;QUIC version 1 握手；&lt;code&gt;http3 = true&lt;/code&gt; 時再送 HTTP/3 &lt;code&gt;GET&lt;/code&gt;，像內建的 &lt;code&gt;http&lt;/code&gt; 檢查一樣看 status 與 body&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;資料庫的檢查也更嚴格：&lt;code&gt;role = &amp;quot;replica&amp;quot;&lt;/code&gt; 現在表示&lt;strong&gt;正在複寫的 replica&lt;/strong&gt;——redis 與 master 的連線是 &lt;code&gt;connected&lt;/code&gt;、MySQL / MariaDB 的 IO 與 SQL thread 都在跑、PostgreSQL standby 有 WAL receiver；搭配 &lt;code&gt;max_lag&lt;/code&gt; 可以限制 replica 落後的秒數。注意：0.3.0 時，複寫中斷但 &lt;code&gt;role = &amp;quot;replica&amp;quot;&lt;/code&gt; 仍算 up 的 redis replica，在 0.4.0 會變成 down。&lt;/p&gt;&#xA;&lt;p&gt;LDAP 的錯誤原因對 Active Directory 也更好讀了：AD 在診斷訊息尾端加的 NUL 字元會被去掉；伺服器在 TLS 握手時直接斷線（AD 沒有 LDAPS 憑證時就是這樣），原因會寫成 &lt;code&gt;tls: connection closed during the TLS handshake (does the server have a certificate?)&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;h2 id=&#34;五其他改變&#34;&gt;五、其他改變&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;內建的 &lt;code&gt;http&lt;/code&gt; 檢查新增 &lt;code&gt;expect_body&lt;/code&gt;：回應內容必須包含指定文字，適合不管狀態如何都回 200 的健康檢查端點。&lt;/li&gt;&#xA;&lt;li&gt;macOS 上，&lt;code&gt;exec&lt;/code&gt; 檢查與 plugin 不再繼承 daemon 的 socket 與 pipe。&lt;/li&gt;&#xA;&lt;li&gt;FreeBSD：rc.d script 以 &lt;code&gt;daemon(8) -f&lt;/code&gt; 啟動，執行 &lt;code&gt;service emfor start&lt;/code&gt; 的 SSH session 不會再卡住。daemon、rc.d script、port 與測試第一次在 FreeBSD 15.1-RELEASE（arm64）上完整跑過。&lt;/li&gt;&#xA;&lt;li&gt;每個 fuzz target 在發版前各跑 10 分鐘。0.4.0 的 plugin 回應、聯防訊息、metrics、plugin 協定與設定檔五個 target，合計跑了約 1,800 萬次，沒有 crash。&lt;/li&gt;&#xA;&lt;li&gt;使用手冊現在也放在這個網站上：&lt;a class=&#34;link&#34; href=&#34;https://embark.systems/emfor/&#34; &gt;emfor 使用手冊&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;六已知限制&#34;&gt;六、已知限制&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;FreeBSD 只在 15.1-RELEASE arm64 上測過；poudriere、14.x 與 amd64 還沒有。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;ldap&lt;/code&gt; plugin 對 Active Directory 只測過沒有憑證、沒有成功登入的情況；&lt;code&gt;mysql&lt;/code&gt; plugin 發佈時只對 MariaDB 測過（發佈後補測：MySQL 8.0 與 8.4 也都通過）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;[store] sync = false&lt;/code&gt;（預設）時，主機當機可能讓 store 損壞；daemon 下次啟動會把它移到一旁，狀態歷史會遺失。手冊第 8 章說明了怎麼把 store 放在 tmpfs 上。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;七怎麼升級&#34;&gt;七、怎麼升級&#xA;&lt;/h2&gt;&lt;ol&gt;&#xA;&lt;li&gt;在每台主機先升級 client：&lt;code&gt;libemfor&lt;/code&gt; 與各語言的套件都要來自 0.4.0。&lt;/li&gt;&#xA;&lt;li&gt;逐台升級 daemon 並重新啟動。有聯防群組的話，升級每台時在它的 &lt;code&gt;[peers]&lt;/code&gt; 加上 &lt;code&gt;encrypt = false&lt;/code&gt;（0.3.0 不認得這個設定，所以不要事先加）。&lt;/li&gt;&#xA;&lt;li&gt;群組裡每台都是 0.4.0 之後，拿掉 &lt;code&gt;encrypt = false&lt;/code&gt;，逐台 reload。&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;p&gt;完整的變更紀錄在 &lt;a class=&#34;link&#34; href=&#34;https://github.com/embark-systems/emfor/blob/v0.4.0/CHANGELOG.md&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;CHANGELOG&lt;/a&gt;，原始碼在 &lt;a class=&#34;link&#34; href=&#34;https://github.com/embark-systems/emfor/releases/tag/v0.4.0&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;GitHub 的 v0.4.0 release&lt;/a&gt;。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h3 id=&#34;-技術協作與架構諮詢&#34;&gt;💡 技術協作與架構諮詢&#xA;&lt;/h3&gt;&lt;p&gt;您的服務是否也面臨健康檢查不一致、故障發現太慢，或檢查流量壓垮 backend 的問題？&#xA;我們能協助您評估架構、導入合適的健康檢查與服務發現機制。&lt;/p&gt;&#xA;&lt;p&gt;🌐 &lt;a class=&#34;link&#34; href=&#34;https://embark.systems/use_cases/&#34; &gt;瀏覽技術實作案例&lt;/a&gt; ｜ 📧 &lt;a class=&#34;link&#34; href=&#34;mailto:service@embark.systems&#34; &gt;預約技術顧問諮詢&lt;/a&gt;&lt;/p&gt;&#xA;</description>
        </item><item>
            <title>emfor 聯防群組：讓同一個機房的健康檢查互相幫忙</title>
            <link>https://embark.systems/posts/emfor-peer-groups/</link>
            <pubDate>Fri, 13 Nov 2026 18:00:00 +0800</pubDate>
            <guid>https://embark.systems/posts/emfor-peer-groups/</guid>
            <description>&lt;img src=&#34;https://embark.systems/images/emfor-peer-vote.zh.png&#34; alt=&#34;Featured image of post emfor 聯防群組：讓同一個機房的健康檢查互相幫忙&#34; /&gt;&#xA;    &lt;blockquote&gt;&#xA;        &lt;p&gt;&lt;strong&gt;2026-11-14 更新：&lt;/strong&gt; 本文依 emfor 0.4.0 修訂。0.4.0 起，非負責主機至少每三個 &lt;code&gt;interval&lt;/code&gt; 自己檢查一次（0.3.0 是每五個），自己的檢查失敗時會開始快速複查；聯防訊息也改為加密。詳見 &lt;a class=&#34;link&#34; href=&#34;https://embark.systems/posts/emfor-0.4.0/&#34; &gt;emfor 0.4.0 的發佈說明&lt;/a&gt;。&lt;/p&gt;&#xA;&#xA;    &lt;/blockquote&gt;&#xA;&lt;h2 id=&#34;一emfor-是什麼&#34;&gt;一、emfor 是什麼&#xA;&lt;/h2&gt;&lt;p&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/embark-systems/emfor&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;emfor&lt;/a&gt; 是一個開源、跑在每一台應用程式主機上的健康檢查 daemon。它定期檢查應用程式所用服務的 backend（TCP、HTTP、Nagios 風格的 script，以及 redis、MySQL、PostgreSQL、LDAP 等 plugin），把哪些 backend 健康寫進同一台主機上的 LMDB 檔案。應用程式要連資料庫時，向 client 函式庫要一個位址；函式庫讀本機檔案、依設定的 &lt;code&gt;balance&lt;/code&gt; 挑出 &lt;code&gt;10.0.3.1:5432&lt;/code&gt; 這樣的答案。&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;              checks over the network&#xA;  backends &amp;lt;------------------------------ emfor daemon ---------&amp;gt; DNS on 127.0.0.1&#xA;                                               |  writes&#xA;                                               v&#xA;                                     local LMDB state store&#xA;                                               |  reads&#xA;                                       client library&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;這個設計的重點是：&lt;strong&gt;查詢不經過網路&lt;/strong&gt;。一次查詢大約一微秒，其他主機或網路出問題時照樣能用。每台主機用自己的設定、從自己的位置看 backend，沒有中央伺服器。&lt;/p&gt;&#xA;&lt;p&gt;但「每台各自看」也有代價。&lt;/p&gt;&#xA;&lt;h2 id=&#34;二每台各自檢查的三個問題&#34;&gt;二、每台各自檢查的三個問題&#xA;&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;1. 發現得慢。&lt;/strong&gt; backend 要連續失敗 &lt;code&gt;fall&lt;/code&gt; 次才會被標成不健康。預設 &lt;code&gt;interval = 2s&lt;/code&gt;、&lt;code&gt;fall = 3&lt;/code&gt;，大約 6 秒。同一個機房裡有二十台主機，每一台都要自己花這 6 秒，而它們看的其實是同一台壞掉的 backend。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;2. 本機看到的不一定是真相。&lt;/strong&gt; 一台主機的檢查失敗，可能是 backend 真的掛了，也可能只是這台主機的網路、防火牆規則或負載出了問題。反過來，一台主機連得上，也不代表其他主機都連得上。單一主機無從分辨。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;3. 檢查量隨主機數成長。&lt;/strong&gt; N 台主機、每台都檢查每個 backend，backend 每個 &lt;code&gt;interval&lt;/code&gt; 就要回應 N 次檢查。主機一多，健康檢查本身就成了 backend 的負擔。&lt;/p&gt;&#xA;&lt;p&gt;聯防群組（peer group）就是為這三件事設計的。&lt;/p&gt;&#xA;&lt;h2 id=&#34;三聯防群組做了什麼&#34;&gt;三、聯防群組做了什麼&#xA;&lt;/h2&gt;&lt;p&gt;同一個機房（&lt;code&gt;site&lt;/code&gt;）的 emfor daemon 在設定檔的 &lt;code&gt;[peers]&lt;/code&gt; 裡列出彼此，就組成一個聯防群組。成員之間用經過簽章的 UDP 訊息溝通，做三件事。&lt;/p&gt;&#xA;&lt;h3 id=&#34;1-故障通知別人發現了我馬上複查&#34;&gt;1. 故障通知：別人發現了，我馬上複查&#xA;&lt;/h3&gt;&lt;p&gt;每個成員每秒送一次 heartbeat，讓大家知道誰還活著。當某個成員看到 backend 從 &lt;code&gt;healthy&lt;/code&gt; 變成 &lt;code&gt;unhealthy&lt;/code&gt;，它通知其他所有成員。收到通知的成員&lt;strong&gt;不會直接相信&lt;/strong&gt;，而是立刻自己重新檢查那個 backend，之後每 200 ms 一次、最多 &lt;code&gt;fall&lt;/code&gt; 次，而不是等到下一個 &lt;code&gt;interval&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;p&gt;結果是：只要有一個成員發現故障，其他成員大約一秒內就會用自己的檢查確認並跟上。通知只是「該看一下了」的提示，從不直接改變 backend 的狀態。&lt;/p&gt;&#xA;&lt;h3 id=&#34;2-多數決三台負責主機投票&#34;&gt;2. 多數決：三台負責主機投票&#xA;&lt;/h3&gt;&lt;p&gt;真正會改變狀態的是投票。存活成員（含本機）有三台以上時，每個 backend 有三台&lt;strong&gt;負責主機&lt;/strong&gt;（assigned checker）。負責主機的挑法是 rendezvous hashing：對每個候選成員計算&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;MD5(&amp;#34;&amp;lt;服務名稱&amp;gt;/&amp;lt;backend&amp;gt;/&amp;lt;成員位址&amp;gt;&amp;#34;) 的前 4 bytes&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;取數值最大的三台。因為每個成員都用同一個公式、看同一份存活名單，不需要任何協調，大家就會挑出同樣的三台；成員加入或離開時，也只有少數 backend 的負責主機會變動。&lt;/p&gt;&#xA;&lt;p&gt;負責主機每次自己檢查後，把結果（&lt;code&gt;up&lt;/code&gt; 或 &lt;code&gt;down&lt;/code&gt;）送給其他成員。每個成員每次檢查後，計算這個 backend 負責主機送來、夠新、而且檢查定義相同的票：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;票的情況&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;結果&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因的寫法&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;兩票以上 &lt;code&gt;down&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;判為 down，即使本機檢查通過&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;peers 2/3: connect: Connection refused&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;不到兩票 &lt;code&gt;down&lt;/code&gt;，本機檢查失敗&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;以本機結果為準&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;local: connect: Connection refused&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;存活成員不到三台，或一票都沒有&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;本機結果原樣使用&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;原本的原因，沒有前綴&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;原因的前綴讓維運人員一眼看出判斷從哪裡來：&lt;code&gt;peers 2/3:&lt;/code&gt; 是群組的共識，&lt;code&gt;local:&lt;/code&gt; 是只有這台主機看到的問題。後者特別值得注意，它通常代表這台主機自己的網路或防火牆有狀況。&lt;/p&gt;&#xA;&lt;p&gt;反過來的情況也看得到：群組判為 down、但本機檢查通過的 backend，&lt;code&gt;emfor status&lt;/code&gt; 會標上 &lt;code&gt;local-up&lt;/code&gt;，&lt;code&gt;emfor_peer_disagreements&lt;/code&gt; 會計數。這種「我連得到、別人連不到」的不一致，往往是網路分割或其他主機上防火牆規則的訊號。&lt;/p&gt;&#xA;&lt;p&gt;「檢查定義相同」也很重要。每個服務的 &lt;code&gt;check&lt;/code&gt;、&lt;code&gt;check_options&lt;/code&gt; 與 &lt;code&gt;timeout&lt;/code&gt; 會算成一個 digest，只有 digest 相同的成員，票才會被計入。兩台主機對同一個服務用不同的檢查方式時，它們的結果不能直接比較，emfor 會在 &lt;code&gt;emfor status&lt;/code&gt; 顯示「check definition differs」，提醒把設定改成一致。&lt;/p&gt;&#xA;&lt;h3 id=&#34;3-分工不是負責主機就少檢查&#34;&gt;3. 分工：不是負責主機就少檢查&#xA;&lt;/h3&gt;&lt;p&gt;有了投票，非負責主機就不必每次都自己檢查。兩台負責主機意見一致時（兩票 &lt;code&gt;up&lt;/code&gt; 或兩票 &lt;code&gt;down&lt;/code&gt;），非負責主機直接採用投票結果，跳過這次檢查。但它不會完全放手：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;至少每三個 &lt;code&gt;interval&lt;/code&gt; 一定自己檢查一次；&lt;/li&gt;&#xA;&lt;li&gt;一致的票少於兩張時，每次都自己檢查；&lt;/li&gt;&#xA;&lt;li&gt;自己的檢查失敗、但負責主機都說 up 時，像收到 &lt;code&gt;down&lt;/code&gt; 通知一樣，開始每 200 ms 一次、最多 &lt;code&gt;fall&lt;/code&gt; 次的快速複查；&lt;/li&gt;&#xA;&lt;li&gt;本機上次檢查失敗時，恢復每個 &lt;code&gt;interval&lt;/code&gt; 都檢查，直到通過；&lt;/li&gt;&#xA;&lt;li&gt;投票說 up、但本機還沒有量到延遲時，自己檢查一次，確保不會在沒有實測的情況下把 backend 判為健康。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;有三台負責主機、N 個成員時，每個 backend 每個 &lt;code&gt;interval&lt;/code&gt; 大約被檢查&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;3 + (N − 3) / 3 次&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;而不是 N 次。以 20 台主機為例，從每個 &lt;code&gt;interval&lt;/code&gt; 20 次降到約 8.7 次。&lt;/p&gt;&#xA;&lt;p&gt;代價是：只有某一台非負責主機看得到的故障（例如只影響這台主機的路由問題），要等到它下一次自己檢查，再加上快速複查才會發現。以 &lt;code&gt;interval = &amp;quot;2s&amp;quot;&lt;/code&gt;、&lt;code&gt;fall = 3&lt;/code&gt; 實測 12 次故障，花了 0.8 到 5.8 秒，中位數 3.3 秒；0.3.0 每五個 &lt;code&gt;interval&lt;/code&gt; 才自己檢查、也沒有快速複查，最長約 14 秒。這是用檢查量換取的延遲，&lt;code&gt;emfor status&lt;/code&gt; 會把這類 backend 標上 &lt;code&gt;voted&lt;/code&gt;，讓維運人員知道這台主機上哪些 backend 主要靠投票判斷。&lt;/p&gt;&#xA;&lt;h2 id=&#34;四設計上守住的幾條線&#34;&gt;四、設計上守住的幾條線&#xA;&lt;/h2&gt;&lt;p&gt;聯防群組加進來之後，emfor 原本的幾個性質都沒有改變：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;查詢仍然只讀本機 store。&lt;/strong&gt; 群組交換的資料只影響 daemon 怎麼判斷，client 函式庫完全不知道群組存在，查詢也不會因此多一次網路往返。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;連不到成員時退回本機判斷。&lt;/strong&gt; 成員停了、網路斷了，投票自然沒有票，daemon 就回到完全依自己檢查的模式，和沒有群組時一樣。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;沒有 master，也不跨機房。&lt;/strong&gt; 每個成員地位相同，負責主機由雜湊決定，不需要選舉。群組限定同一個 &lt;code&gt;site&lt;/code&gt;，因為不同機房看到的網路本來就不同，不應該互相投票。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;訊息要加密、要防重放。&lt;/strong&gt; 每則訊息以從共用密鑰推導的金鑰做 ChaCha20-Poly1305 加密（0.3.0 只有 HMAC-SHA256 簽章、內容是明文），接收端檢查來源位址必須是成員、時間戳與本機時鐘相差不超過 5 秒，並拒絕重送的舊訊息。密鑰可以不停機更換：主機發現自己的密鑰檔改變後，仍用舊密鑰送 60 秒、接受舊密鑰 120 秒。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;五怎麼設定&#34;&gt;五、怎麼設定&#xA;&lt;/h2&gt;&lt;p&gt;在同一個機房的每台主機加上：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;site&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;dc1&amp;#34;&lt;/span&gt;                               &lt;span style=&#34;color:#75715e&#34;&gt;# 有 [peers] 時必填&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;peers&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;listen&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.0.0.5:5302&amp;#34;&lt;/span&gt;                   &lt;span style=&#34;color:#75715e&#34;&gt;# 這台主機在群組裡的位址&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;members&lt;/span&gt; = [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.0.0.5:5302&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.0.0.6:5302&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.0.0.7:5302&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;/etc/emfor/peers.key&amp;#34;&lt;/span&gt;       &lt;span style=&#34;color:#75715e&#34;&gt;# 至少 32 bytes，權限 600 或 640&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;members&lt;/code&gt; 列出每個成員（包含自己），同一份清單可以放在機房裡的每台主機上，只有 &lt;code&gt;listen&lt;/code&gt; 不同。投票與分工沒有額外的設定，直接用各服務原本的 &lt;code&gt;interval&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;p&gt;某些服務不適合聯防，例如檢查結果本來就因主機而異。可以讓個別服務不參加：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;services&lt;/span&gt;.&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;local-cache.svc.emfor&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;check&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;tcp&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;backends&lt;/span&gt; = [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;127.0.0.1:11211&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;peers&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;false&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;設了 &lt;code&gt;peers = false&lt;/code&gt; 的服務在這台主機上不送通知、不送結果、忽略收到的訊息，一律依自己的檢查判斷；其他服務照常聯防。改這個設定只要 reload，backend 的狀態會保留。這台主機會在 heartbeat 裡告訴其他成員它讓哪些服務不參加（每個服務名稱的短雜湊），其他成員挑這些服務的負責主機時就不會算它；只要存活成員夠多，這些 backend 仍有三台會投票的負責主機。所以每台主機可以各自決定哪些服務不參加。聯防群組與這項宣告都是 emfor 0.3.0 加入的，群組裡的每個成員都會讀這項宣告。&lt;/p&gt;&#xA;&lt;h2 id=&#34;六看得到群組在做什麼&#34;&gt;六、看得到群組在做什麼&#xA;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;emfor status&lt;/code&gt; 在 daemon 那一行下面顯示群組狀態：&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;peers: 4/4 live, checks 12/40 backends here&#xA;peers: check definition of api.svc.emfor differs at 10.0.0.6:5302&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;第一行說明成員存活狀況，以及顯示的 40 個 backend 中，有 12 個是這台主機每次都自己檢查的（其餘的標 &lt;code&gt;voted&lt;/code&gt;）。&lt;code&gt;emfor status --json&lt;/code&gt; 還會列出每個 backend 的負責主機：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-json&#34; data-lang=&#34;json&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;assigned_checkers&amp;#34;&lt;/span&gt;&lt;span style=&#34;color:#960050;background-color:#1e0010&#34;&gt;:&lt;/span&gt; [&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  {&lt;span style=&#34;color:#f92672&#34;&gt;&amp;#34;service&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;api.svc.emfor&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color:#f92672&#34;&gt;&amp;#34;backend&amp;#34;&lt;/span&gt;: &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.0.0.11:8080&amp;#34;&lt;/span&gt;,&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;   &lt;span style=&#34;color:#f92672&#34;&gt;&amp;#34;checkers&amp;#34;&lt;/span&gt;: [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.0.0.5:5302&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.0.0.8:5302&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.0.0.6:5302&amp;#34;&lt;/span&gt;]}&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Prometheus 方面，&lt;code&gt;emfor_peer_up&lt;/code&gt; 看成員存活、&lt;code&gt;emfor_peer_messages_rejected_total&lt;/code&gt; 看被丟棄的訊息與原因（&lt;code&gt;auth&lt;/code&gt; 是密鑰不同、&lt;code&gt;stale&lt;/code&gt; 是時鐘偏移、&lt;code&gt;sender&lt;/code&gt; 是成員清單不符）、&lt;code&gt;emfor_peer_disagreements&lt;/code&gt; 看不一致的 backend、&lt;code&gt;emfor_peer_checks_skipped_total&lt;/code&gt; 看分工省下多少檢查。&lt;/p&gt;&#xA;&lt;h2 id=&#34;七小結&#34;&gt;七、小結&#xA;&lt;/h2&gt;&lt;p&gt;聯防群組沒有把 emfor 變成一個分散式系統，它更像是讓同一個機房的 daemon「互相提醒」：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;一台發現故障，其他台約一秒內複查跟上；&lt;/li&gt;&#xA;&lt;li&gt;三台負責主機投票，分辨「backend 真的掛了」與「只是我這台有問題」；&lt;/li&gt;&#xA;&lt;li&gt;非負責主機靠投票省下大部分檢查，backend 的檢查量不再隨主機數線性成長。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;而查詢依然只讀本機檔案、依然在微秒內完成，群組裡任何成員出事，最壞的情況也只是退回每台各自判斷。&lt;/p&gt;&#xA;&lt;p&gt;emfor 的原始碼、完整手冊與設定範例都在 GitHub：&lt;a class=&#34;link&#34; href=&#34;https://github.com/embark-systems/emfor&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;github.com/embark-systems/emfor&lt;/a&gt;。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h3 id=&#34;-技術協作與架構諮詢&#34;&gt;💡 技術協作與架構諮詢&#xA;&lt;/h3&gt;&lt;p&gt;您的服務是否也面臨健康檢查不一致、故障發現太慢，或檢查流量壓垮 backend 的問題？&#xA;我們能協助您評估架構、導入合適的健康檢查與服務發現機制。&lt;/p&gt;&#xA;&lt;p&gt;🌐 &lt;a class=&#34;link&#34; href=&#34;https://embark.systems/use_cases/&#34; &gt;瀏覽技術實作案例&lt;/a&gt; ｜ 📧 &lt;a class=&#34;link&#34; href=&#34;mailto:service@embark.systems&#34; &gt;預約技術顧問諮詢&lt;/a&gt;&lt;/p&gt;&#xA;</description>
        </item></channel>
</rss>
