omegaatt

Unrounded Scaling：Go 1.27 浮點數轉換演算法的深度拆解

raiven.kao@gmail.com (Raiven Kao) — Wed, 26 Aug 2026 00:00:00 +0000

前言

開始之前先看這支影片，講的是 Quake III 那個 0x5f3759df。它跟本文沒有直接關係，但用的是同一類招式：把浮點數的 bit pattern 當成整數讀，用整數的乘加移位取代超越函數。差別在於那一招接受 3.4% 的誤差，而本文接下來要講的東西，一個 bit 的誤差都不能有。這個對照後面定點對數那節會再回來收。

TL;DR 中間一大段是演算法拆解，有興趣再啃。只想知道「Go 1.27 實際上改了什麼、變多快、輸出有沒有跑掉」的話，可以直接跳到 Go 1.27 到底改了什麼，結論是 878 行三套演算法變成 290 行一套、快了 11–21%、輸出零變化。如果你在意的是「那我平常記帳該用什麼」，跳到附錄，那一節比較了 float64、math/big 三兄弟與 shopspring/decimal。

我把 Go 升到 1.27 之後，照慣例翻了一遍 release notes，也寫了新特性整理。整份文件從頭到尾沒有一個字提到 strconv。

但是 Go 1.27 把 fmt.Sprintf("%v", f)、strconv.ParseFloat、json.Marshal 底下那顆浮點數轉換引擎整個換掉了。舊的實作是三套演算法各自為政：最短列印用 Dragonbox、固定位數列印用 Ryū 風格的程式碼、解析用 Eisel-Lemire，新的實作是一個叫 unrounded scaling 的東西，作者是 Russ Cox，論文是 2026 年 1 月才發表的。

這件事之所以值得寫一篇，是因為 Russ Cox 在 2011 年寫過一篇 Floating Point to Decimal Conversion is Easy，副標題是 Part 1。文章的論點是：

Spec-First API：用 codegen 約束 LLM 與人類的 drift

raiven.kao@gmail.com (Raiven Kao) — Tue, 11 Aug 2026 00:00:00 +0000

前言

事情是這樣開始的。

我請 agent 幫忙加一個 endpoint，它三分鐘寫完，handler 乾淨、error handling 完整、unit test 也跟著補齊，go test ./... 全綠。此時我想到的是，agent 真的有做完嗎？route 真的有被註冊嗎？

換成三年前的我，也會漏，那要怎麼樣讓 Agent 不會漏？這個系統從一開始就沒有任何機制能發現有人漏改。以前它靠的是 reviewer 的眼力與同一批人的肌肉記憶撐著；現在把產出速度乘上十倍，這條防線就直接被沖垮了。這不是 agent 的問題，是架構債被提早引爆。

這篇想記錄的，就是後來把這個服務從 code-first 遷移到 spec-first 的過程：用 OpenAPI 當單一真值來源(SSOT)，用 oapi-codegen 產生 typed interface，讓 compiler 與 CI 去做原本靠人記憶的事情。

問題不是「有三份檔案」

遷移前，同一條 API 的定義散落在三個地方：

infra route definition     ← path / method / authorizer
cmd/*/main.go              ← mux.HandleFunc 手寫註冊
Go swag comments           ← @Router / @Param / @Success

三份檔案本身不是問題，同一個概念散在多個檔案是常態。

真正的問題是，它們彼此不知道對方存在。

改 path，可能只改到 Go route，忘了 infra；改 response shape，可能只改 handler struct，忘了註解；授權設定只活在 infra 層，Go 跟 OpenAPI 都不知道有這回事。而 swaggo 的註解在 repo 裡形同空轉，它是「程式碼的產物」，而我們沒有任何機制拿它回頭驗證程式碼。

Golang 1.27 新特性整理：泛型補完與轉正的實驗性功能

raiven.kao@gmail.com (Raiven Kao) — Thu, 06 Aug 2026 00:00:00 +0000

半年前寫完 Go 1.26 新特性那篇，文末問了一句「準備好更新你的 go.mod 到 go 1.26 了嗎？」，沒想到一轉眼 Go 1.27 也要來了。撰文的當下 Go 1.27 即將正式發布，以下內容是根據 release candidate 整理，如果正式版有微調，還是以官方 release notes 為準。

如果說 Go 1.26 給我的感覺是數量多、廣度大，那 Go 1.27 更像是把之前欠的債還一還。generic method 從 issue 一路等到現在終於落地，goroutineleak profile 從需要 GOEXPERIMENT 才能開的實驗功能轉正成預設行為，encoding/json/v2 也從實驗畢業成為預設實作。這篇就挑幾個我覺得值得記錄的改動來聊聊。

語言層面：泛型設計的最後一塊拼圖

Generic Method 真的來了

這件事我在 Go 1.27 即將支援 Generic Method 那篇已經寫得很詳細了，這裡就不重複展開，只放結論：method 現在可以宣告自己的 type parameter，不用再繞道用 package-level function 把 receiver 當參數傳進去。

type List[T any] struct {
    items []T
}

func NewList[T any](items ...T) List[T] {
    return List[T]{items: items}
}

// MapTo 是 generic method，帶著自己的型別參數 U，
// 跟 receiver 的型別參數 T 是兩回事。
func (l List[T]) MapTo[U any](f func(T) U) List[U] {
    out := make([]U, len(l.items))
    for i, v := range l.items {
        out[i] = f(v)
    }
    return List[U]{items: out}
}

type Cat struct {
    Name string
    Age  int
}

cats := NewList(Cat{"Mittens", 3}, Cat{"Tama", 5})
names := cats.MapTo(func(c Cat) string { return c.Name })
fmt.Println(names.items) // [Mittens Tama]

老話一句：interface 目前還是無法宣告帶 type parameter 的 method，這是 dynamic dispatch 架構性的限制，不是漏掉沒做。想看完整的來龍去脈跟 workaround 的比較，去讀前面連結的那篇。

Go 1.27 即將支援 Generic Method：告別 package-level 函式的 workaround

raiven.kao@gmail.com (Raiven Kao) — Wed, 27 May 2026 00:00:00 +0000

前言

Go 1.18 帶來泛型之後，我們終於可以寫出型別安全的通用函式，不再需要到處 interface{} 加型別斷言。但一個眾所周知的限制一直存在到現在，method 沒辦法有自己的 type parameter。

換句話說，這段程式碼在目前的 Go 版本中是非法的：

func (c *Client) doRequest[T any](ctx context.Context, method, path string, body any) (*T, error) {
    // 編譯錯誤：cannot use generic method doRequest without instantiation
}

為了繞過這個限制，大家只能退而求其次，把 receiver 當作普通參數傳進去，改用 package-level 的 generic function。

最近 Go issue #77273 的進展讓這件事有了轉機，generic method 的設計已被接受，預計在 Go 1.27 正式釋出。

為什麼現在沒有 Generic Method？

這不是 Go team 沒想到，而是刻意的設計決策。

Go 的 interface 是核心功能，method 必須能夠被 dispatch 到具體的實作上。如果 method 自身帶有 type parameter，編譯器在 dispatch 時需要知道 T 是什麼，這在動態 dispatch（interface dispatch）的情境下是個難題，runtime 無法事先知道要生成哪個型別的實例化版本。

所以泛型剛推出時，generic method 被刻意排除在外，等待一個比較完整的設計方案。這個等待從 Go 1.18 一路等到了 1.27（暫定）。

把 k3s 從 Ubuntu 搬到 OpenSUSE MicroOS，順便換上 FluxCD GitOps

raiven.kao@gmail.com (Raiven Kao) — Sun, 24 May 2026 00:00:00 +0000

前言

我的 Homelab 跑著一台 Proxmox VE，底下有一個 Ubuntu Server 24.04 的 VM 負責跑 k3s cluster，這個 cluster 接管了家裡所有的自架服務：從 Vaultwarden 密碼管理、Karakeep 書籤、Filebrowser 文件管理，到 Wakapi 開發時間追蹤，大大小小跑了十幾個服務。

這個架構一直跑得很穩。直到 Linux kernel 7.0 發布，我才開始動搖。

kernel 7.0 的各種新特性讓我心癢，Ubuntu 26.04 LTS 剛好以 kernel 7.0 作為預設核心，理論上從 24.04 升上去就能一步到位。但在一個跑著十幾個服務的生產 VM 上執行 do-release-upgrade，那種心臟發抖的感覺，即便有做好備份，還是讓我遲遲下不了手。

就在猶豫要不要升級的當下，我問了自己一個問題：「我要繼續用 Ubuntu 嗎？」

這個問題打開了一扇門。我的 Linux desktop 是 openSUSE Tumbleweed + KDE Plasma，用了三年、換過兩台裝置（筆電和桌電），沒有遇到太多問題。Tumbleweed 的滾動更新讓我一直跑著最新的 kernel，升級這件事從來不是一個需要另外排行程的壓力事件。

既然 desktop 側已經對 openSUSE 生態有信心，server 側為什麼不試試看？

這讓我開始認真考慮：有沒有一種 OS，讓 server 的升級這件事也變成「預設安全」而不是「需要勇氣」？

為什麼選 OpenSUSE MicroOS

OpenSUSE MicroOS 是一個 Immutable OS（不可變作業系統），核心特性有幾個：

Pragmatic Clean Architecture in Go

raiven.kao@gmail.com (Raiven Kao) — Thu, 23 Apr 2026 00:00:00 +0000

前言

在大型系統或需要長期維護的產品中，導入 DDD（Domain-Driven Design）或 Clean Architecture 幾乎是業界的標準答案，分層清晰、職責明確、可測試性高，這些優點毋庸置疑。

但問題是，不是每個專案都是大型系統。

當你面對的是一個內部工具、side project、或是剛起步的新產品，Clean Architecture 的大全套 Use Case、Port、Adapter、Aggregate、Repository Interface 全放 domain，往往會讓你在還沒寫第一行商業邏輯之前，就先在資料夾結構裡迷路了三個小時，或是讓不熟悉的貢獻者花費大量時間在閱讀架構。

這篇文章想討論的是：在不犧牲可測試性與可維護性的前提下，哪些抽象可以捨棄、哪些值得保留，以及我自己踩過的一些坑。

捨棄什麼

獨立的 Port/Adapter 層

Clean Architecture 中，Use Case 透過明確定義的 input/output port 與外界溝通，搭配 Adapter 負責格式轉換。這在大型系統中確實有其價值，但它帶來的代價是：為了讓每一層都能獨立替換，你需要維護大量的介面與轉換邏輯，而這些轉換邏輯往往只是把 A struct 的欄位複製到 B struct。

在小專案中，這條轉換鏈可以大幅縮短。HTTP handler 本身就可以負責 DTO 的轉換，不需要再多一層 Adapter。

DDD 的 Aggregate

Aggregate 是 DDD 中保護業務不變式（invariant）的邊界，透過 Aggregate Root 統一管理相關物件的存取。這個概念本身沒有問題，但在小專案中，如果業務規則還不夠複雜到需要嚴格的不變式保護，過早引入 Aggregate 反而會讓簡單的 CRUD 操作變得冗長。

保留什麼

捨棄了部分複雜度之後，剩下的四層架構已經足以應付絕大多數的小專案需求。

`package domain`

這裡只放 Domain Model 與 Value Object。

值得特別說明 Domain Model 的定義。它不等同於 DDD 裡的 Domain，不是什麼深奧的設計概念，Domain Model 只是在描述「這個應用程式如何跟外部世界互動、邊界在哪」，也就是你的核心資料結構與它們身上的行為。有些「賣課」的人喜歡把 Domain Model 直接等同於 DDD 的 Domain，實際上它是個更基礎、更普遍的概念，可以參考這支影片的解釋。Domain Model 中不需要也不該出現任何技術細節，例如回傳是否是 JSON 等等，這些 Domain Model 甚至要能讓 PM 與非技術人員也「聽的懂」。

k3s Ingress Controller 從 Nginx 遷移到 Traefik 同時整合 CrowdSec

raiven.kao@gmail.com (Raiven Kao) — Sat, 11 Apr 2026 00:00:00 +0000

TL;DR 馬上就看到有小王八蛋想壞壞

前言

2025 年 11 月，Kubernetes SIG Network 發布了一篇公告：ingress-nginx 將正式退役。

這個消息讓不少人震驚，但嚴格來說有個細節需要釐清。目前市場上有兩個長得很像的 nginx ingress controller：

kubernetes/ingress-nginx：由 Kubernetes SIG Network 維護，這次宣布 EOL 的就是它。
nginx/kubernetes-ingress（又稱 NKS）：由 F5 / NGINX Inc. 維護，目前仍持續開發中。

我的 homelab k3s cluster 一直以來用的是 F5 維護的版本，嚴格來說不在這次 EOL 的範圍內。但這個公告還是給了我一個動力，與其繼續追蹤兩個版本之間的差異、擔心哪天又有什麼變化，不如趁這個機會把遷移一次做完。

遷移目標選定 Traefik v3，原因有兩個：

k3s 內建 Traefik 作為預設 Ingress Controller，1.32 版本後升級為 Traefik v3，搭配 HelmChartConfig 管理，和 cluster 的整合度最高。
順手引入 CrowdSec 主動防護——長期以來我的服務靠著 Cloudflare proxy 當唯一守門人，但我一直想要在 Ingress 層就能即時判斷並封鎖攻擊者 IP，而不只是依賴前端的 CDN 過濾。

為什麼不選 Cilium Gateway API

在決定遷移到 Traefik 之前，我也閱讀了 Gene 的告別 ingress-nginx：Cilium Gateway API 遷移筆記，評估過 Cilium Gateway API 方案。Cilium 在 CNI 層整合了 Gateway API，理論上能提供更底層、效能更好的流量控制，且完全符合 Kubernetes Gateway API 的標準規範。

用 Hetzner + Proxmox Backup Server 實踐 3-2-1 備份原則的異地備援

raiven.kao@gmail.com (Raiven Kao) — Tue, 31 Mar 2026 00:00:00 +0000

前言

如果你有認真對待自己的資料，應該聽過 3-2-1 備份原則：

3 份備份
2 種不同的儲存媒介
1 份異地備援

前兩項在家中的 Homelab 環境相對容易做到，但「異地」這個字往往是大多數人的盲點。硬碟壞掉？用 Proxmox Backup Server (PBS) 還原。系統崩潰？從 PBS 拉一份回來。但若是家裡發生火災、淹水，或是更平凡的情況——你不小心把整台 Proxmox VE 的 NVMe 連資料一起刪掉——這時候同一個屋簷下的所有備份都會跟著陪葬。

我的 Homelab 環境是一台 Proxmox VE 搭配一台 Proxmox Backup Server，跑著包含 k3s、Vaultwarden 等各種服務。在研究了很久的異地備援方案後，我決定在歐洲架設一台 PBS，讓它透過 WireGuard 隧道主動把家裡的備份「拉」過去，讓 321 中的那個「1」真正落地。

這篇文章會記錄完整的架構決策過程，從為什麼選 Hetzner、選哪個方案、到實際的設定步驟，以及中間踩過的坑。

為什麼選 Hetzner

Hetzner 是一間位於德國的基礎設施供應商，在評估異地備援的雲端供應商時，我的優先考量是：便宜、隱私安全、技術友善。

GCP / AWS 的問題

第一個念頭當然是最熟悉的 GCP 或 AWS，畢竟都是主流雲端。但把兩者丟進計算機後，答案很快就出來了：

以我「最終」需要的規格：

2 vCPU / 4GB RAM VM
80GB 高速 Storage 用於 PBS 備份
500GB 慢速 Storage 用於 NAS 備份

方案	預估月費
Hetzner - CX23 - 80GB Volume - BX11 Storage Box	約 $15.73 USD
AWS 同級配置 - t3.medium - gp3 80GB - S3 500GB	約 $50 USD
GCP 同級配置	相近

光是這個差距就已經結案了。AWS 和 GCP 的小型運算實例本身就已經比 Hetzner 貴好幾倍，Block Storage 的單價更是幾乎翻倍，再加上對外流量費用（下載資料還要另外收），災難復原時光是把 500GB 拉回來就可能要多付幾十美元。

放棄 Electron 與 Tauri? 我用 Wails + HTMX 打造 3MB 的跨平台桌面應用

raiven.kao@gmail.com (Raiven Kao) — Mon, 09 Mar 2026 00:00:00 +0000

Web 仔要有 Web 仔的自覺

前言

前陣子收到了 Murphy 的需求，嘗試使用 Tauri 寫了一個桌面 App。Tauri 結合 Rust 與 React 的體驗相當不錯，打包出來的體積也十分理想。

但身為一個主要撰寫 Golang 的後端工程師，內心總有一個聲音：「如果能用 Go 來寫桌面應用，那該有多好？」

眾所周知，Golang 在原生的 Desktop GUI 框架上一直沒有特別強勢的殺手級專案（過去使用 Fyne 的經驗不算太好）。在環顧了一眾基於 Chromium 的 Electron 或是基於系統 WebView 的 Tauri 後，決定走一條稍微不一樣的「老路」：使用 Wails 搭配 HTMX 與 Templ。

最終的產物就是 Dub 一個跨平台的批次檔案重新命名工具。更甚，在 Linux 上打包出來的可執行檔只有約 3MB，並且完美支援 macOS 與 Linux，且幾乎沒有複雜的前端狀態管理負擔。

為什麼是 Wails + HTMX？

在選擇桌面應用程式的技術方案時，我們通常有幾個考量

Electron: 開發體驗極佳，生態系最豐富，但代價是動輒上百 MB 的體積與高昂的記憶體佔用。對於一個小工具來說，太過沉重。（這也是我優先選擇 Zed.dev 作為主要編輯器的原因）
Tauri: 效能極佳，體積小，但後端需要寫 Rust。雖然 Rust 很香，但有時候只想用最熟悉的 Go 快速把邏輯刻出來。
Wails: 與 Tauri 類似，採用前端網頁技術結合系統原生 WebView，但後端語言是 Golang。

既然選了 Wails，前端該用什麼？現代前端框架（React, Vue, Svelte）通常需要建置複雜的 SPA（Single Page Application），並透過 JSON API 與後端溝通。但對於一個狀態並不複雜的工具軟體，不想在前端再維護一份狀態。

旅遊札記 - 2026 新年的關西遊

raiven.kao@gmail.com (Raiven Kao) — Fri, 20 Feb 2026 00:00:00 +0000

在 2025 Recap 的展望中寫下了「與 +1 首次踏足國外」，沒想到兌現的速度比預期快得多，2026 年的第二天，我跟 Murphy 就站在了關西國際機場。

會選擇日本關西作為首次出國的目的地，原因很單純：我們都各自來過，作為初次日本自由行，熟悉的地方還是比較安心。加上 2025 年 10 月才從五十音開始學日文，正好拿這趟旅程來驗收 N87 的日文實力（？

五天的行程，從京都走到大阪，從零度的細雪走到通天閣的暖陽。這篇拖了快兩個月才動筆的遊記，就當作是對這趟旅程的交代吧。

Day 1（1/2）：初雪與初売り

搭乘星宇航空 JX820 班次，Airbux A330-900neo 機型，這次旅行選擇星宇也是為了體驗 Airbus 的飛機。11:10 分落地後，11:20 分就開始排隊出關（這邊禁止拍照），11:40 順利出關拿完行李！原本預計出關會要約莫一個半小時，訂了 12:44 分的 JR Haruka 由於關西國際機場極高的效率讓我們在機場空等了一小時 XD。

由於吃了暈機藥，在 Haruka 時仍持續處於昏迷狀態，抵達京都時已經下午兩點，隨即轉乘烏丸線到烏丸御池站，出站走了一小段路就到了這兩晚的住所，Hotel Resol Trinity Kyoto（京都RESOL TRINITY酒店）。

我與 Murphy 在這次旅行的分工是，我負責京都部份，Murphy 負責大阪部份，而京都的住宿，我只花了半小時搜尋「京都住宿 ptt」就搞定了，我並沒有過多研究 Hotel Resol 整體的歷史等等，單純是因為飯店的窗戶有一個紙門設計，我就被迷惑了。好在運氣始終不錯，當從京都的大馬路上轉進小巷子，一間外裝不太起眼的飯店映入眼前，進入飯店後裝潢與外裝截然不同，雖然知道他是ホテル但濃濃的りょかん味，特別是一樓還有大浴場，這兩天我都在這邊洗澡，所以並沒有感受到評價所說的「浴室很小」的感覺。由於是新年期間，附近的學校也跟著放假，大廳還提供了原先供應給學校的鮮乳，屬實幸運。

下榻的飯店距離錦市場只有十分鐘的步行距離，放完行李後，緊接著步行前往藤井大丸，體驗日本新年的「初売り」，此時室外的溫度零度，天空飄下了細雪，即便十分興奮，還是會擔心外套濕掉。我高估了我耐寒的能力，只穿了短袖、中層與棉質的薄外套就來了這零度的京都，Murphy 在大丸買了件新的羽絨外套後，我就把他身上的搶過來穿，撐過了這幾天。買完戰利品後先回到飯店放下，畢竟我們接下來還有行程，這就是飯店距離商圈近的好處。

Clean Craftsmanship：在 LLM 時代重拾軟體工匠精神

raiven.kao@gmail.com (Raiven Kao) — Thu, 19 Feb 2026 00:00:00 +0000

為什麼在這個時間點讀這本書

最近對於如何在 LLM 時代帶領團隊一起提昇生產力感到困惑。當 AI 能在幾秒鐘內生成幾百行程式碼，「寫程式」這件事的門檻似乎降到了前所未有的低點。但門檻低了，品質呢？

當「每個人」都在養龍蝦，有了生產力焦慮，TypeScript 寫的 OpenClaw 才剛出現，Python 的 NanoBot 馬上跟上，接著是 Golang 的 picoclaw，然後 Rust 的 ZeroClaw 也來了。

根據 ZeroClaw 做的 benchmark，這些 Agent 已經降到小於 5MB 的記憶體佔用與 10ms 的啟動時間，「種族」為人類的我們對於產出軟體來說還剩什麼？

帶著這個問題，我決定先從自身出發，找出在 LLM 時代還能保持軟體工程「工匠精神」的誘因。於是翻開了 Robert C. Martin 的 Clean Craftsmanship。

這本書分為三個部份：紀律、標準、道德。一半以上的篇幅在講述 TDD 這個老生常談的開發方式，但透過 TDD，我們更能知道何謂軟體的「品質」。以下是我特別書籤的幾個段落。

紀律

童子軍規則

離開營地時，要比你來時更乾淨。

這也是在 Clean Code 一書就提到的概念。每次微小的重構，都能小程度的減少技術債的產生。不需要一次大刀闊斧，只要每次經過一段程式碼時，順手讓它變得更好一點。

讓我想到 Claude is not a senior engineer (yet) 這篇文章中提到的 Sweeks——一位被稱為「園丁」的 distinguished engineer，他不斷地重寫、收緊抽象，讓經過他手的程式碼都變得更乾淨。我們都想成為 Sweeks，對吧？

在 LLM 時代，AI 擅長的是「組裝」現有解決方案，但它缺乏 Sweeks 那種「看到可以更好的地方就會忍不住動手」的靈魂。童子軍規則提醒我們：這份靈魂不能丟。

Test Doubles 的正名

書中透過實戰的例子講述了所有 test double：Dummy、Stub、Spy、Mock、Fake。

坦白說，我曾經在諸多 repo 中看到這些名詞卻沒有實際使用它們。頂多在 DI 時製作了一個「用於模擬 database repository 的 implement」，或是使用了 gomock 這種套件來產生 mock，然後把所有替身都統稱為 mock。

Golang 1.25 testing/synctest 初體驗：告別在測試中寫 time.Sleep 的日子

raiven.kao@gmail.com (Raiven Kao) — Sun, 18 Jan 2026 00:00:00 +0000

前言

在我們目前的應用程式架構中，由於高度與 Kubernetes 耦合，服務啟動與運作期間需要頻繁地去讀取 K8s 中的 ConfigMap。為了達成配置熱更新（Hot Reload），我們引入了 Kubernetes client-go 中的 informers 機制來監聽 ConfigMap 的 CRUD 事件。

雖然 K8s 官方提供了 fake client 讓我們能測試 informers 的邏輯，但在 Service Code 的層級，我們往往需要封裝一層更適合業務邏輯的 ConfigWatcher。Golang 引以為傲的輕量級 Goroutine 與 Channel 搭配非常適合用來處理這種非同步的事件傳遞。

然而，一旦涉及到 Goroutine 的非同步測試，「時間」往往就成了最大的敵人。

遇到的問題：不穩定的測試與魔法數字

為了模擬 ConfigMap 的變更通知，我們定義了一個 ConfigMapWatcher 介面與對應的 Event 結構：

const (
	ConfigMapUpdateEventTypeAdded ConfigMapUpdateEventType = iota
	ConfigMapUpdateEventTypeModified
	ConfigMapUpdateEventTypeDeleted
)

type ConfigMapUpdateEvent struct {
	Name  string
	Type  ConfigMapUpdateEventType
	Value map[string]string
}

type ConfigMapWatcher interface {
	Watch(ctx context.Context, eventCh chan<- ConfigMapUpdateEvent) error
}

接著，我們很自然地在 testing 中實作了一個 fake 物件來模擬事件發送：

type fakeConfigMapWatcher struct {
	injectCh  chan ConfigMapUpdateEvent
	watchErr  error
	watchOnce sync.Once
}

func newFakeConfigMapWatcher() *fakeConfigMapWatcher {
	return &fakeConfigMapWatcher{
		injectCh: make(chan ConfigMapUpdateEvent),
	}
}

func (f *fakeConfigMapWatcher) sendEvent(event ConfigMapUpdateEvent) {
	f.injectCh <- event
}

func (f *fakeConfigMapWatcher) Watch(ctx context.Context, eventCh chan<- ConfigMapUpdateEvent) error {
	if f.watchErr != nil {
		return f.watchErr
	}

	f.watchOnce.Do(func() {
		go func() {
			for {
				select {
				case <-ctx.Done():
					return
				case e := <-f.injectCh:
					eventCh <- e
				}
			}
		}()
	})
	return nil
}

問題來了，當我們在寫單元測試時，呼叫 sendEvent 將事件送入 channel 後，消費者端（也就是我們的業務邏輯 Goroutine）並不會「立刻」收到並處理完成。為了確保 assert 斷言執行時，業務邏輯已經跑完了，我們被迫在測試中加入 time.Sleep：

RouterOS v7.21 container + App 組合拳，你的下一台 Router 也可以是 All In One Homelab

raiven.kao@gmail.com (Raiven Kao) — Sat, 17 Jan 2026 00:00:00 +0000

前言

自從 RouterOS 在 v7.13 引入 container 功能後，這為我們這些 Homelab 愛好者開啟了一扇新的大門。我們終於可以在路由器上原生執行 container，這意味著一些網路相關的基礎設施服務（Infrastructure Services）可以從原本的伺服器中遷移出來。

以我為例，過去我的 Adguard Home 是 deploy 在我的 Homelab 伺服器群中。然而，作為一個喜歡「折騰」的工程師，Homelab 難免會因為硬體更換、系統升級或是實驗新架構而需要重啟。每當這時候，家裡的網路 DNS 解析就會中斷，隨之而來的就是家人的抱怨。

為了解決這個單點故障（SPOF）的問題，我決定將 Adguard Home 改為 deploy 在 Router (RB5009UG) 上。這樣做不僅減少了物理上的 latency，更重要的是將「網路服務」與「應用服務」解耦，避免因為 Homelab 的維護而導致全家斷網。

這是遷移後的狀態：

[user@RB5009UG] > container print
Flags: R - RUNNING
Columns: NAME, ROOT-DIR, INTERFACE, MOUNTLISTS, ENTRYPOINT
#   NAME                                  ROOT-DIR                     INTERFACE    MOUNTLISTS         ENTRYPOINT
0 R b51e0424-8fce-4c3d-b4bb-6493f76aa24b  /usb1/container/adguardhome  adguardhome  adguardhomeConfig  /opt/adguardhome/AdGuardHome

RouterOS v7.21 的新變革：App

而在最近發布的 RouterOS v7.21 中，Mikrotik 給我們帶來了更方便的 container 部署方式，他們稱呼為 App。

Container Image Optimization 那些年我們寫錯的 Dockerfile

raiven.kao@gmail.com (Raiven Kao) — Wed, 14 Jan 2026 00:00:00 +0000

最近在檢視公司內部的專案時，針對其中一個 container image 進行了優化。在一個簡單的 commit 後，我們的 image size 從 1.82GB 修正到了 1.18GB。

透過 dive 查看，Image Efficiency 更是從不及格的 69% 飆升到了 99%。

這讓我回想起過去寫 Dockerfile 時，常常因為不了解 Docker Layer 的機制，或是為了寫起來「方便」，而踩到了許多效能與安全的地雷。

致命的 `chown`

這次優化的核心，其實源自於一個非常常見的操作：修改檔案權限。

在我們的案例中，Dockerfile 原本是這樣寫的：

# Bad Practice: recursive chown after copy
FROM ubuntu:22.04

WORKDIR /app
COPY . .

# ... install dependencies ...
RUN dpkg -i packages/*.deb

# Change ownership for security reasons
RUN groupadd -r appuser && useradd -r -g appuser appuser
RUN chown -R appuser:appuser /app

看起來邏輯很正確：把檔案複製進去，安裝套件，最後為了安全性將檔案權限交給非 root 使用者。

Golang 1.26 新特性在數量上史無前例的多

raiven.kao@gmail.com (Raiven Kao) — Tue, 13 Jan 2026 00:00:00 +0000

隨著時間來到 2026 年初，Go 語言迎來了 1.26 版本的更新。如果說 Go 1.18 的泛型是語言層面的重大變革，那麼 Go 1.26 則是在「數量」與「廣度」上讓人感到驚艷的一次釋出。從語言特性的語法糖、標準庫的實用擴充，到 Runtime 效能的顯著提升（Green Tea GC），甚至是實驗性的 SIMD 支援，這次的更新內容豐富到讓人目不暇給。

本文將挑選其中幾個我認為對日常開發最重要、或最有趣的改動來進行介紹。

語言層面的改動

`new(expr)`：終於不用再寫輔助函數了

在 Go 1.26 之前，如果我們想要取得一個基本型別（如 int, bool, string）的 pointer，通常需要宣告一個變數或者寫一個輔助函數。這在定義 struct 的 literal 時特別煩人，尤其是當 struct 欄位是 *bool 或 *int 用來區分「零值」與「未設定」的時候。

回顧過去，我們為了這個小需求付出了不少努力：

在 Go 1.18 泛型出現之前：我們經常需要定義一堆如 Int64Ptr(v int64) *int64 或 Float64Ptr(v float64) *float64 的輔助函數（AWS SDK 的使用者應該對此非常熟悉）。
匿名函數大法：如果不想要定義全域的輔助函數，有時甚至會看到像 enabled := func(b bool) *bool { return &b }(true) 這種冗長且難讀的寫法。
泛型時代：雖然可以用一個通用的 ptr[T] 解決，但還是需要額外的程式碼。

以前我們可能需要這樣做：

func ptr[T any](v T) *T {
    return &v
}

type Config struct {
    Enabled *bool
}

conf := Config{
    Enabled: ptr(true),
}

在 Go 1.26 中，內建的 new 函數得到了增強，現在它不僅接受型別，還可以直接接受表達式（Expression）。

從 GrapheneOS 回歸原廠：Google Pixel 5 刷機紀錄

raiven.kao@gmail.com (Raiven Kao) — Sat, 10 Jan 2026 00:00:00 +0000

最近整理抽屜時，翻出了這台陪伴我一段時間的 Google Pixel 5。

身為一個喜歡折騰的開發者，早在它退役成為備用機時，我就第一時間把它刷成了 GrapheneOS。不得不說，GrapheneOS 在隱私保護和安全性上做得真的很好，沒有 Google Play Services 的純淨體驗也別有一番風味（雖然依賴 Sandboxed Google Play 還是能解決大部分 App 的問題）。

但就在前幾天，或許單純是想念 Pixel 原生系統的那些獨家功能（原生相機等等），我決定讓它「回歸原廠」。

原本以為又要經歷一番 adb 和 fastboot 的指令轟炸，還要自己去 Google 官網下載好幾 GB 的 Factory Image 壓縮檔，解壓後再祈禱 flash-all.sh 不要噴錯。

沒想到現在 Google 官方提供了一個方便的網頁工具：Android Flash Tool。

這篇文章簡單紀錄一下如何從 GrapheneOS 這種 Custom ROM，透過官方工具刷回 Stock Firmware 的過程。

為什麼選擇 Android Flash Tool？

以前刷機的標準作業流程（SOP）：

搜尋正確的 Factory Image（還要對型號，買到電信商鎖定版就哭哭）。
下載 Android SDK Platform-Tools。
解鎖 Bootloader。
執行 flash-all script。
遇到驅動程式問題、傳輸線問題、路徑問題…

現在的 Android Flash Tool 直接把這些步驟簡化了：

WebUSB: 直接透過瀏覽器與手機溝通，不用煩惱太底層的驅動設定（至少在 macOS/Linux 上是這樣）。
Auto Detect: 自動偵測裝置型號，自動下載對應的最新版韌體。
Fool-proof: 圖形化介面引導你開啟 USB Debugging 和 OEM Unlocking。

事前準備

雖然工具很強大，但基本的準備還是要有的：

2025 Recap

raiven.kao@gmail.com (Raiven Kao) — Sun, 28 Dec 2025 00:00:00 +0000

當兩個人意見不一致，可能其中一個人是錯的。如錯錯的人是你，難道你不想知道嗎？

出自 Ray Dalio 的《原則》一書，是我 2025 年對自己的提問。

接續 2023 年展望，與 2024 Recap，用這篇文章來紀錄今年的自己。

可以搭配今年度最常聽的音樂 Again (Yui Acoustic Version)

工作

去年把工作放到最後，今年則是放到第一位。今年換到了新的公司、新的工作崗位，從十幾位 RD 的新創公司，換到了有一千多位 RD 的大公司。即便已經沒有過去擔憂的「過度官僚」文化，但仍在職也不好多說什麼。

整體來說目前待的團隊，是夾雜著無趣卻也有趣的產品，無趣的點在於產品本身並不性感，目標客群是企業客戶，幾乎沒有什麼創新的概念。有趣的點在於，如何在有限的時間內拓展產品線，並且以 UX 的角度來思考企業客戶如何使用產品，並花費更多時間在前期的 design，而不是單就功能進行開發，時常會需要花費八成的時間在前期規劃，真正的開發時間就是靠 AI(LLM) 解決。

隨著團隊拓展，我也承擔了 mentor 的責任，第一次帶新人多少有些徬徨與無助。隨著團隊擴展，漸漸的開始反思現代軟體開發，一件一個人能完成的事情被拆成四五個人都要有貢獻，導致交付速度不升反降，這樣真的是正確的嗎？我想還需要更多的時間積累才能找到答案。

不得不提的就是，目前的公司有「近乎無限」的 AI 資源（特別指 LLM），讓手速不再成為寫程式的瓶頸。與前東家不同的是，這間公司是在今年才開始轉型 AI First，並且透過 sharing & AI Hackathon 來推廣 AI 在內部開發與產品上的使用。不過觀察下來，年初的 AI 使用率應該是不高的，就連我這個 AI 質疑論者，都能被邀請去 All Hands 進行 AI 使用的 session。

健康

今年在健康上只能說完全荒廢，與去年底期許的目標，不僅完全沒有維持，更糟糕的是因為通勤距離變遠了，導致運動時間大幅下降。

但…

我想這一切都只是藉口，單純只是變懶惰、沒了動力。只能把希望寄託在 2026 年，能透過「12周做完一年工作」這本書內提到的方法，不設定目標，而是設定行動，先把行動給完成再看看怎麼推進了。

旅遊

隨著離開新創公司，又回到了下班不認識的那個自己，今年多數旅遊都是跟 Murphy 兩人，連爬山也變少了，希望 2026 年能投入更多時間在旅遊上。

Helm Smart Resource：讓你的 Chart 學會與既有資源和平共處

raiven.kao@gmail.com (Raiven Kao) — Sat, 22 Nov 2025 00:00:00 +0000

前言

在 Kubernetes 的世界裡，Helm 無疑是管理應用程式部署的霸主。它標準化了資源的定義，讓我們可以用宣告式的方式管理整套系統。然而，在真實世界的維運場景中，事情往往沒那麼單純。

我們常遇到一種尷尬的情況：某些資源（例如 Database 的 Secret、外部系統的 ConfigMap）可能在 Helm Chart 安裝之前就已經由維運人員手動建立，或是由另一個流程（如 Terraform）預先準備好了。

這時候，如果直接執行 helm install，往往會收到 “resource already exists” 的錯誤；如果使用 helm upgrade --install，又擔心 Helm 會覆蓋掉這些既有設定。

這篇文章將分享一種「Smart Resource」的設計模式，透過 Helm 的 lookup 函數與樣板邏輯，讓你的 Chart 能夠聰明地判斷：「這東西是我管的嗎？如果是，我才動它；如果不是，我就尊重現狀。」

核心難題：Ownership

在 Kubernetes 中，資源的「所有權」觀念至關重要。Helm 預設認為它 release 中的所有資源都應該由它全權管理。但當我們需要與外部資源協作時，我們需要更細緻的控制。

我們的目標很明確：

若資源不存在：建立它，並標記為 Helm 管理。
若資源已存在且由 Helm 管理：更新它（Patch/Merge）。
若資源已存在但由外部管理：保持原狀，不進行覆蓋或刪除。

為了達成這個目標，我們需要一個輔助函數來判斷資源的歸屬權。

實作細節

1. 定義所有權檢查

首先，我們在 _helpers.tpl 中定義一個檢查函數。Helm 會在它建立的資源上打上特定的 Annotations（meta.helm.sh/release-name 和 meta.helm.sh/release-namespace）。我們可以利用這一點來判斷資源是否屬於當前的 Release。

{{/*
Check if a resource is owned by this Helm release
Returns "true" or "false" as string for stable piping
*/}}
{{- define "visionone-filesecurity.isOwnedByRelease" -}}
{{- $resource := .resource -}}
{{- $releaseName := .releaseName -}}
{{- $releaseNamespace := .releaseNamespace -}}
{{- $owned := and $resource
    (hasKey $resource.metadata "annotations")
    (eq (get $resource.metadata.annotations "meta.helm.sh/release-name") $releaseName)
    (eq (get $resource.metadata.annotations "meta.helm.sh/release-namespace") $releaseNamespace)
-}}
{{ printf "%t" $owned }}
{{- end -}}

這段程式碼邏輯很簡單：只有當資源存在，且其 Annotations 中的 Release Name 與 Namespace 都與當前 Release 相符時，才視為「Owned」。

Interface 不是有開就好：從一個 PR 來看抽象化的重要性

raiven.kao@gmail.com (Raiven Kao) — Sat, 04 Oct 2025 00:00:00 +0000

前言

最近團隊正在開發一個新產品，其中一個核心功能需要 client 與 server 之間進行即時、雙向的溝通。經過一番技術評估，我們決定採用 WebSocket 來實現這個需求。

身為一個良好習慣的開發團隊，我們在開發初期就導入了依賴注入（Dependency Injection），希望透過界面（Interface）來解耦商業邏輯與具體的實作，這樣不僅能提高程式碼的可測試性，未來在更換底層實作時也能更加輕鬆。

一切聽起來都很美好，直到我在一次 Code Review 中，看到了一段熟悉的程式碼。

一個 PR 的故事

在我們的 Domain Layer，也就是處理核心商業邏輯的地方，我看到同事定義了下面這個 interface：

// package/to/domain/service.go

// WebSocketService defines the interface for websocket communication.
type WebSocketService interface {
    // StartAndLinsten starts the service and listens for incoming messages.
    StartAndLinsten(ctx context.Context) error

    // Send sends a message to the client.
    Send(ctx context.Context, message any) error

    // ... other methods
}

第一眼看過去，好像沒什麼大問題。有名稱、有方法、也確實是個 interface。然而，當我細看 WebSocketService 這個命名時，總覺得哪裡怪怪的。

於是我在 PR 上留下了這樣的 comment：

這個界面主要是抽象化 client 與 server 間的互動，不應該侷限於 WebSocket 這個 Protocol。假如我們未來要換成使用 socket.io 或是 gRPC stream，是不是連 domain 層的 interface 也要跟著改動？

監控你的執行檔：初探 watchexec

raiven.kao@gmail.com (Raiven Kao) — Sat, 06 Sep 2025 00:00:00 +0000

前端開發有 liveserver，後端開發有 air，那 TUI 開發呢？本文記錄了我在開發 Bubbletea 應用時，從 air 轉向 watchexec 的心路歷程，以及如何使用這個通用工具來優雅地實現終端機應用的熱重載。

用 Golang Bubbletea 打造終端機應用：從 Hello World 到多頁面架構

raiven.kao@gmail.com (Raiven Kao) — Fri, 05 Sep 2025 00:00:00 +0000

探索如何使用 Golang 的 Bubbletea 函式庫，基於 Elm 架構，從零開始打造一個互動式終端機應用（TUI）。本文將從一個簡單的計數器範例，逐步引導你建構出一個類似 Web 應用的多頁面架構，並分享整個生命週期中的關鍵概念與注意事項。

初探 Tauri：為了解決朋友的繁瑣任務，寫了個桌面 App

raiven.kao@gmail.com (Raiven Kao) — Wed, 27 Aug 2025 00:00:00 +0000

一個非工程師朋友的日常繁瑣任務，成為我初探 Tauri 的契機。本文記錄如何使用 Rust 的強大後端結合 React 的靈活前端，打造一個輕量、跨平台的桌面應用，來解決真實世界的問題。

Prompt to Product：AI 時代開發者的範式轉移

raiven.kao@gmail.com (Raiven Kao) — Sun, 10 Aug 2025 00:00:00 +0000

那些年我們追逐的開發效率

還記得第一次聽到「十倍工程師」這個詞的時候，心中總是充滿憧憬。想像著有一天也能寫出十倍的程式碼、處理十倍的任務、創造十倍的價值。每當看到某個同事在短時間內完成複雜的功能，總是會想：他們是不是真的擁有某種神秘的超能力？

隨著經驗的累積，漸漸發現這更像是一個美麗的神話。真正的效率並不在於敲擊鍵盤的速度，也不在於記住多少語法細節。那些看似神奇的十倍效率，往往來自於對問題本質的深刻理解，以及選擇正確工具的智慧。

直到 ChatGPT 橫空出世，Agentic AI 開始進入我們的開發流程，我開始思考：AI 能為我們帶來什麼？又有什麼是它永遠無法取代的？

從懷疑到接受的心路歷程

最初的抗拒與恐懼

坦白說，剛開始接觸這些 AI 工具時，我的內心是抗拒的。作為一個有著多年開發經驗的工程師，看著這些「會寫程式的機器」，心中五味雜陳。那種感覺就像是突然有人告訴你，你引以為傲的專業技能可能會被一個沒有情感的演算法取代。

第一次使用 AI code assistant 時，我提出一個簡單的需求：「幫我寫一個排序函數」。當它瞬間給出了完整且正確的程式碼時，我的第一反應不是驚喜，而是擔憂。這些工具真的實用嗎？會不會最終取代我們這些工程師？依賴 AI 是否會讓我們的技能退化？

這些疑慮很真實，也很合理。畢竟，我們這個行業向來對「銀彈」保持謹慎態度。太多次，我們看到某個新技術被吹捧為「革命性的」，最終卻發現它只是解決了某個特定問題，而創造了十個新問題。

重新定義效率的數學陷阱

然而，在實際使用 Zed AI、GitHub Copilot Agent 等工具幾個月後，我發現自己的思維框架需要調整。「十倍工程師」的概念確實存在一個隱藏的數學陷阱，而理解這個陷阱是擁抱 AI 輔助開發的第一步。

我開始仔細觀察 AI 在哪些環節能夠提供幫助。當我需要寫一個複雜的正則表達式時，AI 能在幾秒鐘內給出準確的答案，而我可能需要查資料和測試十幾分鐘。當我需要重構一個大型函數時，AI 能夠快速理解程式碼邏輯並提供多種重構方案。當我需要撰寫技術文件時，AI 能夠幫我整理思路，甚至提供不同角度的表達方式。

但同時，我也清楚地感受到 AI 的局限。當系統編譯時，AI 無法讓 CPU 運算得更快。當測試套件在 CI 環境中執行時，AI 無法讓網路延遲消失。當我需要與產品經理討論需求細節時，AI 無法代替我進行那些微妙的人際溝通。當面對複雜的架構選擇時，AI 可以提供選項，但最終的決策仍需要結合業務上下文和長期策略考量。

有一天，一位同事興奮地告訴我：「用了 AI 工具後，我覺得自己的開發速度提升了十倍！」我問他：「你的專案交付時間真的縮短了十倍嗎？」他想了想，搖搖頭說：「沒有，可能只快了兩三倍。」這就是數學陷阱的本質：AI 能夠大幅加速某些特定環節，但整個開發流程的速度受限於最慢的那個環節。

從工具使用者到架構思考者

這種認知的轉變讓我重新審視自己作為開發者的角色定位。AI 的出現並沒有降低我們的價值，反而讓我們從機械性的程式碼編寫中解放出來，有更多時間專注於真正重要的事情：理解業務需求的本質、設計優雅的系統架構、做出明智的技術選型決策。

我開始意識到，真正的「十倍效率」不是來自於打字速度的提升，而是來自於思維方式的轉變。當 AI 幫我們處理了大量重複性工作後，我們有機會成為更好的架構師、更好的問題解決者、更好的技術領導者。

機器可讀設計的哲學革命

經過這段時間的實踐，我得出了一個看似簡單但意義深遠的核心理念：「只有機器可讀的設計，才能被 LLM 加速」。

重新審視我們的設計習慣

這個理念讓我開始重新審視過去的工作習慣。回想一下我們是如何管理專案的：每次設計評審，我們會花費大量時間製作精美的 PowerPoint，其中包含各種流程圖、架構圖、時序圖。這些圖表在投影幕上看起來很專業，但會議結束後，它們就被儲存為 PNG 或 PDF 格式，靜靜地躺在某個共享資料夾中，再也沒有人會去更新或維護。

如何利用 Golang AST 助攻 LLM 省 token 又高效

raiven.kao@gmail.com (Raiven Kao) — Mon, 16 Jun 2025 00:00:00 +0000

前言

近來大型語言模型（LLM）的發展可謂一日千里，特別是在程式碼理解、生成與輔助開發方面，展現出了驚人的潛力。許多開發者開始嘗試將 LLM 融入到日常工作中，期望能提昇開發效率，甚至實現所謂的「vibe coding」——讓 LLM 理解程式碼的整體風格與意圖，並在此基礎上進行協作。

然而，當我們試圖讓 LLM 直接「閱讀」整個大型專案的程式碼庫時，往往會碰到一些現實的挑戰。上下文長度限制、高昂的 token 消耗以及潛在的雜訊干擾，都可能讓 LLM 的表現不盡如人意。這時候，我們就需要更聰明的方法來為 LLM「提煉」程式碼的精華。

在這篇文章中，我想分享一個在 Golang 專案中可能被忽略的利器：抽象語法樹（Abstract Syntax Tree, AST）。透過 Golang AST，我們可以更精準地提取程式碼的結構資訊，為 LLM 提供一份濃縮且高效的上下文，既能節省寶貴的 token，又能幫助 LLM 更好地把握「Code Vibe」。

LLM 直接消化大型 Code Base 的「痛」

想像一下，你正在開發一個頗具規模的 Golang 後端服務，裡面包含了數十個套件、數百個檔案。現在，你想讓 LLM 幫你新增一個功能，或者重構某個模組。如果直接把所有相關的程式碼一股腦地丟給 LLM，可能會遇到以下這些令人頭痛的問題：

token 消耗「爆表」：LLM 的使用成本與輸入輸出的 token 數量直接相關。將大量原始碼作為輸入，無疑會產生巨額的 token 費用，對於個人開發者或小型團隊來說，這可能難以承受。
「腦容量」不足的上下文限制：即使是目前頂尖的 LLM，其能夠處理的上下文長度也是有限的。面對龐大的程式碼庫，LLM 可能無法一次「看」全所有必要的資訊，導致理解片面或生成結果不佳。
資訊過載與雜訊干擾：完整的程式碼中，充斥著各種細節——註解、空行、詳細的錯誤處理邏輯、暫時用不到的私有函式等等。這些資訊對於 LLM 理解程式碼的「vibe」或執行特定高層次任務（例如「模仿現有風格新增一個 API 端點」）來說，有時反而會成為雜訊，影響其判斷。
龜速的回應：通常情況下，輸入給 LLM 的資訊越多，它處理並生成回應所需的時間就越長。在追求高效開發的今天，漫長的等待顯然不是我們想要的。

面對這些挑戰，我們不禁要問：有沒有一種方法，可以只給 LLM「剛剛好」的資訊，讓它既能理解我們的意圖，又能高效地完成任務呢？Golang AST 或許就是答案的一部分。

Golang AST 如何「助攻」

在我們深入探討 AST 如何幫助 LLM 之前，先快速回顧一下什麼是 Golang AST。

一次核心模組的重構經驗

raiven.kao@gmail.com (Raiven Kao) — Sat, 14 Jun 2025 00:00:00 +0000

前言

在軟體開發的漫漫長路中，我們時常會接手一些充滿「歷史印記」的專案。這些專案的核心模組，往往因為業務的快速迭代與時間的無情沖刷，逐漸演化成難以觸碰的「史前巨獸」。近期，我便有幸（或許該說是不幸地）參與了一次這樣核心模組的重構之旅，其核心是我們產品線廣泛使用的 Golang gRPC 認證攔截器 (Interceptor)。這段經歷充滿挑戰，但也收穫良多，希望能藉此分享一些心得。

歷史的塵埃：核心模組的演進悲歌

我接手的這個核心認證模組，在專案初期或許設計簡潔明瞭，但隨著產品線的不斷擴展和需求的堆疊，其複雜度已然失控。追溯其演進的脈絡，彷彿能看到一部小型技術債的形成史。

最初的起點：單純的 gRPC Interceptor

可以想見，專案伊始，對於 gRPC 服務的認證需求相對單純。一個通用的攔截器或許就能滿足所有需求，程式碼結構清晰可見：

package main

func SimpleAuthInterceptor(...) {
    log.Println("Performing basic authentication via SimpleAuthInterceptor")
    return handler(ctx, req)
}

func SimpleStreamAuthInterceptor(...) error {
    log.Println("Performing basic stream authentication via SimpleStreamAuthInterceptor")
    return handler(srv, ss)
}

func main() {
    lis, err := net.Listen("tcp", ":50051")
    if err != nil {
        log.Fatalf("failed to listen: %v", err)
    }

    s := grpc.NewServer(
        grpc.UnaryInterceptor(SimpleAuthInterceptor),
        grpc.StreamInterceptor(SimpleStreamAuthInterceptor),
    )

    log.Println("gRPC server listening on :50051")
    if err := s.Serve(lis); err != nil {
        log.Fatalf("failed to serve: %v", err)
    }
}

在這個階段，一切看起來是那麼的美好與純粹。

Golang Iterator 簡介與 samber/lo 比較

raiven.kao@gmail.com (Raiven Kao) — Sat, 31 May 2025 00:00:00 +0000

自從 Golang 1.18 版本引入泛型（Generics）後，Go 語言的生態系統迎來了許多令人興奮的變化。其中，Golang 1.23 版本對 Iterator（迭代器）的標準化，以及 iter 套件的加入，無疑是近期改動中相當重要的一環。本文將淺談 Golang Iterator 的基本概念，深入探討 Pure Iterator 與 Impure Iterator 之間的區別與設計考量，並與社群中流行的 samber/lo 工具庫進行比較。

什麼是 Iterator？

Iterator Pattern（迭代器模式）是一種常見的設計模式，它提供了一種循序存取集合物件中各個元素的方法，而又無需暴露該物件的內部表示。簡單來說，Iterator 就像一個指針，可以依序指向集合中的下一個元素，直到遍歷完所有元素為止。

Golang 中的 Iterator

在 Golang 1.23 之前，我們通常透過 for-range 迴圈來迭代 array、slice、string、map、channel 等內建資料結構。然而，對於自訂的資料結構或複雜的序列生成邏輯，缺乏一個統一的迭代標準。

Golang 1.23 版本正式將 Iterator 標準化，並在標準庫中加入了 iter 套件。同時，slices 和 maps 套件也增加了一些回傳 Iterator 的工廠函數（Iterator Factories）。到了 Golang 1.24，更有如 strings.SplitSeq 等函數加入，進一步豐富了 Iterator 的應用場景。

// strings.SplitSeq 回傳一個迭代器，用於遍歷由 sep 分隔的 s 子字串。
// 此迭代器產生的字串與 Split(s, sep) 回傳的相同，但不會建構整個 slice。
// 它回傳一個單次使用的迭代器。
func SplitSeq(s, sep string) iter.Seq[string]

如果對 Golang 1.23+ 中 Iterator 的語法和語義還不熟悉，建議可以閱讀 Ian Lance Taylor 在 Go 官方部落格發表的介紹文章

告別 Docker Desktop 束縛！macOS 容器實戰：colima + k8s + containerd 踩坑遷移全記錄

raiven.kao@gmail.com (Raiven Kao) — Sat, 19 Apr 2025 00:00:00 +0000

前言

身為一個開發者，特別是在 macOS 環境下，Docker Desktop 幾乎是容器化開發的標配。然而，自從 Docker Desktop 開始針對大型企業調整其授權模式後，許多開發者開始尋找替代方案。

市面上確實出現了一些選擇，例如閉源但功能強大的 OrbStack。但對於熱愛開源的我來說，目光自然投向了社群。這時，colima 這個開源專案進入了我的視野。它不僅提供了一個在 macOS 上運行 Linux 容器的輕量級方式，還內建了 Kubernetes 支援，引起了我極大的興趣。

這篇文章，想記錄一下我從 Docker Desktop 轉換到 colima，並且在 colima 的 Kubernetes 環境中，從原本依賴 Docker Engine 逐步遷移到使用 containerd 作為容器執行時（Container Runtime）的心路歷程與踩坑經驗。

lima 與 colima 簡介

在深入 colima 之前，得先提一下 lima (Linux virtual machines on macOS)。lima 是一個旨在於 macOS 上輕鬆運行 Linux 虛擬機的開源專案。它底層利用了 macOS 的虛擬化框架（如 QEMU 或更高效的 vz），提供了一個相對輕量的 Linux VM 環境。

而 colima 則可以看作是建立在 lima 之上的「使用者友善層」。它簡化了 lima 的配置，並專注於提供容器執行時環境。colima 可以讓你輕鬆地啟動一個配置好 Docker 或 containerd 的 Linux VM，並且可以選擇性地啟用 Kubernetes (K3s) 支援。簡單來說，colima 幫你處理了建立 VM、安裝 Runtime 等繁瑣步驟，讓你專注在容器本身。

建構多平台的 container image

raiven.kao@gmail.com (Raiven Kao) — Sun, 30 Mar 2025 00:00:00 +0000

前言

最近在搞 side project 時，常常需要在不同的 CPU 架構上跑我的應用程式。例如，開發用的 MacBook 是 ARM 架構 (Apple Silicon)，開發用的 Desktop 是 x86 架構（Ryzen 5900X），而部署的伺服器可能是 x86 (AMD64)，有時候甚至想在 Raspberry Pi (ARM) 上跑些小東西。每次都要為不同平台分別建構 image 實在有點麻煩，而且 Registry 上一堆 xxxapp-amd64, xxxapp-arm64 的 tag 看了也很礙眼。經過一番研究與嘗試，是時候接觸 Docker Buildx 了。

為什麼需要多平台映像檔

在 wintel 的商業策略下，以及大家對高性能伺服器的普遍認知，主要用 x86/amd64，但現在 ARM 架構越來越普及，從 Apple Silicon 的 Mac、AWS Graviton 處理器、各種 IoT 設備到你的 Raspberry Pi，ARM 無所不在。如果你的 container image 只支援 amd64，那它就無法在這些 ARM 設備上原生運行 (需要模擬，效能差)。為了Build Once, Run Anywhere，多平台映像檔 (Multi-platform images) 就是 meta。

OCI 多平台映像檔架構簡述

其實不複雜。傳統的單一平台 image，它的 manifest 指向一組設定檔和一堆 layer。而多平台 image 則是透過一個 manifest list (索引) 指向多個特定平台的 manifest。每個特定平台的 manifest 才各自指向該平台的設定檔和 layer。

Never Install Locally？試試 Dev Container

raiven.kao@gmail.com (Raiven Kao) — Sat, 01 Mar 2025 00:00:00 +0000

最近換了新工作，到了一間資訊安全公司，讓我更加重視開發環境的安全。

還記得之前分享過透過 Distrobox 解決 Linux 環境依賴問題，用他來解決不同 Linux distribution 的依賴關係，背後即是讓程式跑在 container 內。

既然能夠將應用程式一來透過 container，與 Host OS 本身做出區隔，那麼我們也能透過 container 來對開發的依賴做出隔離。於是，開始擁抱 Dev Container，一個能讓我更安心、更有效率（？）的開發環境。

什麼是 Dev Container？

簡單來說，Dev Container 就是把開發環境「容器化」。我們可以把所有需要的工具、函式庫、設定檔都放在一個 Docker Image 裡，然後用這個 Image 啟動一個 Container 作為你的開發環境。

Consistency (一致性)：不管是在哪台機器上開發，只要有 Docker，就能保證開發環境完全一致。再也不用擔心「在我這台電腦上可以跑啊！」這種崩潰的狀況發生。
Isolation (隔離性)： Dev Container 與本機系統完全隔離，可以避免各種依賴衝突，也能保護系統安全。
Reproducibility (可重現性)：透過 Dockerfile，你可以完整記錄你的開發環境設定，方便團隊協作和版本控制。

為什麼需要 Dev Container？

身為一個資安從業人員，Dev Container 解決了以下痛點：

不同版本的 Node 環境，告別 nvm！需要 node14, node16, node18 或是 stable 版本，隨時產生開發環境。
需要下載 malware 到本地進行 e2e 測試，透過 container 進行蛤蜊（🦪意象），盡可能避免破壞系統安全性。
在 macOS 上解決一些只支援 linux 的 binary，或是在 arm64 host 上透過 rosetta2 模擬 x86_64 環境，進而執行 amd64 執行檔。
使用 rootless 模式，在危機四伏的 npm 環境中，確保開發環境的安全性。

我的 Dev Container 工作流

我將 dev-container 放在 github omegaatt36/lab/dev-container 中，以下 demo 僅「目前版本」，會依據使用情境進行迭代。

使用 go work 在本地開發解決同時開發 module 的問題

raiven.kao@gmail.com (Raiven Kao) — Thu, 20 Feb 2025 00:00:00 +0000

在 Golang 1.18 中 go workspace 的提案釋出後，golang 的官方文件或多或少也提到應該要怎麼做 multi module 的開發。相較於過去需要不斷的替換 go.mod 內的 replace 指令，go work 大幅改善了 multi module 的開發體驗。

為什麼需要 go work

專案逐漸變大

當你在維護一個小工具 side project 時，單一的 module 就能夠滿足所有需求，但當專案逐漸變大，會需要將專案拆分成多個 module。可以透過一個例子來理解：假設我們有一個專案，拆分成以下兩個 module：

common-lib-golang: 存放所有專案都會用到的 function，例如 retry, logger, tracer 等等
backend: 實際提供 http api 的程式碼

最開始的檔案架構為：

.
├── backend
│   ├── go.mod
│   ├── go.sum
│   └── main.go
└── common-lib-golang
    ├── go.mod
    ├── go.sum
    └── util.go

隨著專案變大，我們在開發 backend 時，時常會需要修改 common-lib-golang 內的程式碼，這時候就需要 go work 來協助我們。

在習慣 go mod 後重新學習 git submodule

raiven.kao@gmail.com (Raiven Kao) — Fri, 24 Jan 2025 00:00:00 +0000

前言

使用 Golang 作為主要開發已經有五年的時間。最近因工作需要接觸到 Python 專案，並且該專案使用 git submodule 的方式來引用共同函式庫 common-lib-python。對於長久使用 Golang 的 go mod 的我來說，submodule 是一個相對陌生的概念。藉這個機會撰寫一篇文章，整理並紀錄一下 git submodule 的用法，也作為未來的參考。

這篇文章會假設已經對 git 的基本操作有一定程度的了解，並著重在 submodule 的概念、使用情境以及與 Golang 的 go mod 的差異比較。文章內容會以下列流程來呈現：

建立一個新的 Python 專案 my-python-repo
建立一個 Python 模組 my-python-module 作為 submodule
在 my-python-repo 中使用 my-python-module 作為 submodule
模擬需求變更，同時修改 my-python-repo 與 my-python-module，並分別發送 PR
與 Golang 的 go mod 進行比較

建立 Python 專案與模組

先建立兩個新的 git repo，分別是 my-python-repo 與 my-python-module。

# 建立 my-python-repo
mkdir my-python-repo
cd my-python-repo
git init
touch main.py
git add .
git commit -m "Initial commit"

# 建立 my-python-module
cd ..
mkdir my-python-module
cd my-python-module
git init
touch my_module.py
git add .
git commit -m "Initial commit"

# 將兩個專案 push 到 Github/Gitlab 上

my-python-repo 與 my-python-module 都已經是一個獨立的 git repo。

Golang Composition over Inheritance

raiven.kao@gmail.com (Raiven Kao) — Sat, 11 Jan 2025 00:00:00 +0000

Golang 是一門簡潔有力的程式語言，相較於其他程式語言，更傾向於使用組合（composition）而不是繼承（inheritance），語言設計之初更是沒有提供繼承的關鍵字，這種設計哲學讓 Golang 在現代軟體開發中脫穎而出。

繼承固然有其優點，但在建構複雜的物件關係時，容易產生過於龐大的繼承層級結構。這使得程式碼難以閱讀和維護，就像是一棵盤根錯節的大樹，牽一髮而動全身。

過深的繼承層級會導致知名的「脆弱基類問題」(fragile base class problem)，使得程式碼難以修改和擴展。

組合則不同，它鼓勵建立小型、專注的 struct，然後像樂高積木一樣，將這些 struct 組合成更大的結構。這種方式讓程式碼模組化，更容易理解和修改。

彈性

Golang 的 type system 支援我們靈活地組合各種 struct。可以建立一個新的 struct，並在其中「嵌入」其他 struct 作為其欄位。

type Car struct {
    make  string
    model string
    year  int
}

type Driver struct {
    name string
    car  Car
}

func main() {
    myCar := Car{"Toyota", "Camry", 2020}
    driver := Driver{"John", myCar}
    fmt.Println(driver.name)         // 輸出: John
    fmt.Println(driver.car.make)    // 輸出: Toyota
}

在這個例子中，Driver 透過組合 Car 來建立更豐富的資料結構。Driver 「has-a」 Car，而不是「is-a」 Car，這提供了更高的彈性，讓 Driver 可以更專注在自身的邏輯。

程式碼複用

組合促進了程式碼的複用。可以建立許多小型、可複用的 struct，然後將它們組合成各種不同的結構。

繼承也能實現程式碼複用，但它也可能導致不必要的耦合，使得程式碼難以修改，因為對父類別的修改可能會影響到所有子類別。

type Engine struct {
    power      int
    fuelType   string
}

type Wheels struct {
    count      int
    material   string
}

type Vehicle struct {
    engine Engine
    wheels Wheels
    brand  string
}

func (v Vehicle) getBrand() string {
    return v.brand
}

func (v Vehicle) getEnginePower() int {
    return v.engine.power
}

在這個例子中，Vehicle 透過組合 Engine 和 Wheels 來複用這兩個 struct 的欄位和功能。Vehicle 「has-a」 Engine and 「has-a」 Wheels，並可以新增自己的欄位和方法，例如 brand、getBrand() 和 getEnginePower()。這種方式讓 Vehicle 可以專注於自身的邏輯，同時又能複用 Engine 和 Wheels 的功能。

使用 Templater 來提昇 Obsidian 的生產力

raiven.kao@gmail.com (Raiven Kao) — Thu, 02 Jan 2025 00:00:00 +0000

這篇文章不涉及 Obsidian 完整使用說明以及 Templater 完整使用教學，僅以一個 use case 來展現如何使用 Templater 來提昇 Obsidian 的使用效率。

前言：

工作日誌，是一個甜蜜的負擔，有些人是因為公司要求，開始寫工作日誌，逐漸流於形式。

最初我也是因為工作需要「彙報」，才開始寫工作日誌。直到開始跑 scrum，開始明白 standup meeting 的意義，開始在意如何讓 stackholder 放心把事情交給我做，於是

參考了《SCRUM：用一半的時間做兩倍的事》以及實際執行的經驗，以下是我認為良好的彙報需要注意的關鍵因素：

昨天的進度：簡要說明昨天完成的具體工作，重點在成果而非過程。
今天的計劃：說明今天的工作重點，聚焦在需要達成的具體目標。如果是要跨超過一天的工作，也需要設定一個預計能完成的時間。
遇到的障礙：明確指出當前的問題或挑戰，並說明需要的幫助。當然也沒有必要什麼事都等到 standup meeting 才提出問題，有障礙應當即時反應。
與其他團隊或成員的依賴：說明需要其他人或團隊支持的地方，確保協作順暢，例如後端需要寄送的 email 內容，需要前端協助產生 html 等等。
以終為始、以成果為導向：聚焦於交付成果的進展，而非細節，例如：目前已完成 80% 的登入模組開發，預計明天可以驗收。

詳細的舉例不是這篇文章的重點，有空可以再寫成其他文章 D:

上述幾個要點，在工作日誌中被我濃縮成 markdown 的格式：

XXXX-XX-XX

昨日：
- 昨日1
- 昨日2
瓶頸：
- 瓶頸
今日：
- 今日1
- 今日2

Obsidian

高中時接觸了 markdown，大學接觸了 Hackpad，畢業後延續這個習慣，使用 Hackmd 來管理自己的工作日誌。

隨著時間的增長，開始發現 Hackmd 無論是官方 hosting 的免費版與企業版，或是 self-hosted 的 CodeMD，在單一大檔案編輯文件時，都會有明顯的延遲。若我將工作日誌拆成多個月份，又不好管理。

在 2023 年轉換工作之際，開始尋找其他 markdown 文字編輯器。

2024 Recap

raiven.kao@gmail.com (Raiven Kao) — Tue, 31 Dec 2024 00:00:00 +0000

假如你的答案更好，書本上的答案一點也不重要。

2024 年 12 月 13 日過世的查爾斯．韓第，在《你拿什麼定義自己？》中如此寫到，這句話也在 2024 年改變了我做決策的方式。

在 2022 年底寫了 2023 年展望，轉眼間兩年就要過去了，在 2024 年底紀錄一下這一年的回顧，以及未來的展望。

健康

今年是特別注重健康的一年，無論是身體健康或是心靈健康。

年初的健康檢查，發現陪伴我四年的輕度脂肪肝消失了，於是開始不忌口的胡亂飲食。八月底看不下去體重的增長，開始戒零食與珍珠，也開始跑健身房有氧與無氧，從高點的 75 公斤掉到 68 公斤。明年的期望是體脂肪降到 15% 並且同時能夠增肌到體重 70 公斤。

在三月也開始牙齒矯正，好在不需要拔牙，約莫一年到一年半即可以完成矯正。傳統矯正的缺點是鐵線會一直刮到嘴皮、需要專門的牙籤才好剔牙齒，但感到最不方便的是，需要完成矯正才能捐血 QAQ。

在年中旬，發現有些 Burn Out，好在身邊的同事與朋友們，願意花時間開導、給與職涯上的建議，才能順利的調整過來，今年感受到滿滿的溫暖。

旅遊

今年原本是預計要去高島縱走、合歡山、大霸尖山等等，但因為突如其來的地震、颱風而全數取消，不過透過照片回顧，今年還是去了不少地方的。

跨年

Murphy 考到了駕照，跨年去到了台東，沒有駕照的我就當個優良的副駕，較特別的是，我們在紅烏龍的故鄉鹿野，誤打誤撞進入了碧蘿園。

台北大縱走第四段

去年開始找同事爬山，今年終於成團出發。(照片合併到下面)

開源軟體的雙面刃：免費背後的隱藏成本

raiven.kao@gmail.com (Raiven Kao) — Fri, 01 Nov 2024 00:00:00 +0000

每日例行地開啟最愛的 Save for later，準備觀看有哪些部落格更新、產品釋出新版本時，一行醒目的提示告訴你「我們即將關閉伺服器」。

錯愕，這是 2024 年十月底每一位 Omnivore App 難民的心情。

一、開源軟體的普及與迷思

說到開源軟體，不外乎就是 free 或是 freedom 的軟體，可以說是免費的軟體，也可以說是自由的軟體。

早期的 LAMP Stack 相較於 Microsoft 的 Windows Server、IBM 或是 Oracle 付費的服務，每個組件都是免費的，廣泛受到 Geek 到大中小型企業的使用

同時，開源軟體顧名思義是開放原始碼，在授權許可下可以自由使用、修改、分享，許多人將開源與安全劃上等號。

二、開源軟體的安全現況

多雙眼睛的侷限

即便開放原始碼，所有人都能查看開放原始碼，如果有任何 bug 或是安全漏洞，都「應該」會被發現。我使用「應該」一詞，正因為許多人（包含我）在安裝開源軟體時，就如同安裝閉源軟體一樣，並不會查看全部的程式碼，確認安全後才進行安裝。而是做一個「大家都看過了，應該很安全」的假設。例如當你想用 Nginx 取代 Apache 時，可能僅會比較兩者的 feature 與 benchmark，並不會查看內部 tcp socket 是如何管理等等，或是 buffer overflow 時的錯誤處理機制。

開源是否暴露更多漏洞？

####安全問題的挑戰

當我們將軟體開源，等於是將所有安全問題也給暴露了出來。

舉例來說，假如我們 self-hosted 一個 NAS 服務，這個 NAS 使用指定的 port 進行 web 與 API 的存取，例如 :8787。當一個 Hacker 看到該 NAS 的 Auth 並沒有任何 rate limit，就可以直接在 NAS 內進行 port scan 或是 brute force 攻擊，取得這個 NAS 服務的控制權。

Golang 1.22 中 http routing 的改進

raiven.kao@gmail.com (Raiven Kao) — Wed, 30 Oct 2024 00:00:00 +0000

Golang 作為一個偏向 server 應用的程式語言，一般的 web server 並不會直接使用原生的 package net/http，而更多的使用 gin-gonic/gin 或是 gorilla/mux，後來也有 labstack/echo 以及 go-chi/chi 等等選擇，在效能、輕量、好維護、好擴充中，都能找到對應的 third party package，其中的原因不外乎是原生的 package 提供的功能過於簡潔。

好在 1.22 中，官方改進了 net/http 中對於多工器、路由，甚至出了一篇部落格，現在更可以「大膽的」直接使用 standard library。

Path Parameter

若要將應用的 Web API 定義成 RESTful，我們會使用 /資源/{資源唯一識別符}/子資源/{子資源唯一識別符} 來定義路徑。假如要獲取一個使用者的訂單，則會使用 GET /users/1/orders 來獲取。在 1.22 以前，我們只能定義到 /users，再自行解析往後的 path：

http.HandleFunc("/users", func(w http.ResponseWriter, r *http.Request) {
    subPath := strings.TrimPrefix(req.URL.Path, "/users/")
    if len(subPath) == 0 {
        xxx
    } else {
        ooo
    }
    ...
})

而在 1.22 中新增了 net.http 對 path parameter 的支持，我們可以直接使用 (*http.Request).PathValue("xxx") 來獲取：

http.HandleFunc("/users/{user_id}", func(w http.ResponseWriter, r *http.Request) {
    userID := r.PathValue("user_id")
    ...
})

不過也帶來一些限制

使用 TinyGo 與 Raspberry pi pico 實現溫濕度感測器

raiven.kao@gmail.com (Raiven Kao) — Wed, 02 Oct 2024 00:00:00 +0000

前言

作為嵌入式系統學習的微小專案，我決定使用 TinyGo 來實現一個簡單的溫濕度感測器。過去我大多使用 Arduino 作為微控制器（MCU）開發平台，但這次想嘗試使用 TinyGo 來進行單片機的學習。 TinyGo 是 Go 語言的一個子集，專門針對小型設備和微控制器進行了優化，使得我們可以在資源受限的硬體上運行 Go 程式。

全部的程式碼都可以到 omegaatt36/pico-bme280 中找到。

硬體選擇

Raspberry Pi Pico

我選擇了 Raspberry Pi Pico 作為本專案的主控板。Pico 是一款基於 RP2040 晶片的微控制器開發板，具有以下特點：

雙核 ARM Cortex-M0+ 處理器，時脈可達 133 MHz
264KB 的 SRAM 和 2MB 的板載閃存
支援 USB 1.1 主機和設備功能
低功耗睡眠和休眠模式
可編程 I/O（PIO）狀態機
30 個 GPIO 引腳
便宜

價格僅需要 5 美元，後繼款的 Pico 2 仍然維持 5 美元，還額外增加了 RISC-V 架構的支援，可以一次玩到兩種處理器架構。 Pico 的這些特性使其非常適合用於各種嵌入式專案，包括我們的溫濕度感測器。

BME280 感測器

最初我購買了 BMP280 感測器，但後來發現它只能測量溫度和氣壓，無法測量濕度。因此，我轉而選擇了 BME280 感測器，它可以同時測量溫度、濕度和氣壓。

BME280 是一款精確度高、體積小、待機功耗低的環境感測器。但當連續偵測時，通過的電流會導致 sensor 功耗上升，進而導致測量到過高的溫度。

A smarter way to change directory: zoxide

raiven.kao@gmail.com (Raiven Kao) — Tue, 24 Sep 2024 00:00:00 +0000

在日常的開發工作中，我們經常需要在不同的目錄間切換。雖然 cd 命令已經足夠好用，但如果有一個更聰明的工具能記住我們最常用的目錄，並讓我們用最少的按鍵就能快速跳轉，那豈不是更棒?

這就是 zoxide 的用武之地。zoxide 是一個由 Rust 編寫的「更聰明的 cd 命令」，靈感來自 z 和 autojump。它會記住你最常使用的目錄，讓你只需輸入幾個字符就能快速跳轉。

zoxide 的主要特性

自動匹配: 不需要輸入完整路徑，zoxide 會根據輸入自動匹配最相關的目錄：
自動紀錄過去的目錄: zoxide 會記住你最常使用的目錄，讓你只需輸入幾個字符就能快速跳轉。這些資料可以使用 zoxide query 來查詢，或是 zoxide edit 來管理。
互動式選擇: 結合 fzf，可以互動式地選擇目標目錄
輕量快速: 用 Rust 編寫，啟動迅速，幾乎不會影響 shell 的啟動時間

安裝與配置

zoxide 的安裝可以參考官方文件，我們就不多贅述了。

安裝完成後，我們需要在 shell 的配置文件中添加初始化命令。以 zsh 為例，在 ~/.zshrc 的末尾添加:

eval "$(zoxide init zsh)"

重新打開終端或執行 source ~/.zshrc 後，zoxide 就可以使用了。

使用方法

zoxide 的基本用法非常直觀，經過自動執行 zoxide init zsh 後，我們可以使用 z 和 zi

自動匹配:

❯ ls
  boo bar baz
❯ z bo
❯ pwd
  /home/raiven/boo

即便沒有輸入完整路徑，也能夠自動匹配最相關的目錄

❯ pwd
  /home/raiven/dev/omegaatt-blog
❯ z
❯ pwd
  /home/raiven
❯ z blog
❯ pwd
  /home/raiven/dev/omegaatt-blog

互動式選擇:

❯ zi
~ < 98/98(0)
296.0 /home/raiven/dev/omegaatt-blog
124.0 /home/raiven/dev/bookly
 50.0 /home/raiven/dev
 24.0 /home/raiven/dev/test
 12.0 /home/raiven/

這裡的 z 命令就像一個更聰明的 cd，而 zi 則是互動式版本。

使用 Bitwarden 與自架後端 Vaultwarden 來管理密碼與 2FA Authenticator

raiven.kao@gmail.com (Raiven Kao) — Sun, 01 Sep 2024 00:00:00 +0000

在尋覓有哪些 self-hosted 專案好玩時，偶然發現了 1password、LastPass 的開源替代方案，甚至後端資料庫能自架，決定架來用用看。

為什麼要自架？完全控制資料、隱私考量、或者純粹是學習和折騰 (符合 self-hosted 精神)。但控制權也意味著責任，特別是安全和備份。

這篇會專注在使用 Bitwarden 客戶端搭配輕量級的 Vaultwarden 後端。

使用 Bitwarden 來管理密碼

Bitwarden 是一款流行且功能強大的密碼管理工具，它提供了一個安全的方法來存儲和管理所有密碼。作為一個開源產品，Bitwarden 允許用戶選擇自行托管其服務，這意味著用戶可以在自己的服務器上運行 Bitwarden，從而更好地控制自己的數據安全。

Bitwarden 的特點

安全性: Bitwarden 使用端到端加密，確保只有您可以訪問您的密碼。
跨平台支持: 支持 Windows、macOS、Linux、Android 和 iOS。
易於使用: 提供直觀的用戶界面和簡單的操作流程。
開源: 開源，增加了透明度和安全性。

Bitwarden 同時支援基於時間的一次性密碼，讓 TOTP 也能自動填入。也能透過 github.com/scito/extract_otp_secrets 來提取 Google Authenticator 內的 2FA 資訊，儲存進 Bitwarden 中。

Bitwarden 開源了 client 與 server，在 server 端的選擇有以下：

使用 Bitwarden 提供的官方服務，又分為免費跟付費，但這個選擇就跟 1p 沒太多區別。
自架 Bitwarden 提供的 open source server，由於是使用 C# 與 mssql，吃的記憶體著實太多。
自架 Bitwarden 相容的後端，我採用的是 rust 實做的 Vaultwarden，搭配 sqlite，記憶體使用量與官方的 C# 不是一個量級的。

Bitwarden 架構

bitwarden 的 local storage 都是儲存加密後的密碼資料，不會使用明碼儲存，故上傳到 server 上的也僅僅是加密後的密碼資料。

在 Firefox 上使用 PWA 將網頁應用安裝成 Desktop App

raiven.kao@gmail.com (Raiven Kao) — Sun, 25 Aug 2024 00:00:00 +0000

前言

開應用時，跨平台的桌面解決方案時常困擾開發者，在 Linux Desktop 上要支援多種桌面協議與桌面管理系統，更是複雜許多。時常會看到 Electron 等等基於 chromium 的技術。

當然也可以像是 zed.dev 這樣的 geek 精神，自己寫了一套跨平台的 GUI 框架，但多數新創公司可能沒有這些資源來實現。例如已經非常成熟的 Notion.so、Obsidian 等等都是基於 Electron 實現的。

我並非一個 anti-Electron 或是 deGoogle 的人，但試圖找到其他解決方案正式樂趣之所在。

PWA(Progressive Web App）

詳盡的 PWA 技術可以到 mozilla 的文件中查看，對我來說只要可以達到目的：可以在 Windows、Mac、Linux 上封裝成 Desktop Aplication 即可。

官方支援

mozilla 官方有一個文件針對「安裝網頁應用到桌面環境」的歷史講解，可以參考官方文件。

文中提到過去將網址「儲存」在桌面上的類似「書籤」的方法(SSB)，以及與 PWA 的不同之處：PWA 的使用者資料是儲存在桌面環境中。

PWA Add-on

上述文件內有提到需要使用 Fan-maded 的 PWA Add-on 來安裝 PWA：Progressive Web Apps for Firefox by Filip Štamcar。

他是一個開源的 Firefox 擴充套件(filips123/PWAsForFirefox)，具有完整的文件。

安裝過程

在 Firefox 瀏覽氣上安裝 PWA Add-on
瀏覽器會自動跳到設定頁面，首先會需要同意 EULA
接著會需要安裝 connector，需要透過該 connector 才能連結瀏覽器本身與 extension。 connector 由 Rust 編寫，使該 extension 可以在跨平台的桌面環境中管理 firefox 設定檔、runtime 等等未開放給 extension 存取的資源。

Windows: Windows 的 connector 除了手動安裝外，也推薦使用 winget 來安裝，類似於 apt/yum 的套件管理工具。
Linux Linux 的 connector 可以到 github release 上找到，例如我的作業系統是 OpenSUSE Tumbleweed，則可以下載 .rpm 檔案。
```
sudo zypper in ./firefoxpwa-2.12.1-1.x86_64.rpm
```
- Debian/Ubuntu(DEB):
- Redhat/Fedora/OpenSUSE(RPM):

接著會需要安裝不同於原生 Firefox 的 runtime，根據描述，會下載並由 connector 自動修改成支援 PWA 的 runtime。
到這邊已經完成 PWA extension 的安裝，可以嘗試使用 PWA 的方式來安裝 web app to desktop app。
首先需要打開你想要安裝成 Desktop App 的網頁，如果在不同的網頁嘗試設定，extension 會自動判斷該網頁 CORS Error，即便是 https://www.notion.so 與 https://notion.so 也屬於不同的 Origin。接著點擊 PWAForFirefox 的圖示，可以看到已經安裝好的 extension。
接著一步一步的跟著指引設定好該 PWA 的設定。
完成，可以在應用程式選單內找到剛剛建立的 PWA 應用程式。
開啟後可以自動開啟網頁應用程式，並具有獨立的設定檔。

使用感受

三四年前在 Windows 上習慣使用 Notion Desktop 版本，在 Linux 上反而已經習慣要用網頁來打開，這次嘗試使用 PWA 後倒是經常忘記有將它安裝成 Desktop Application。

透過內建的 pprof 工具來分析 Golang 發生的 memory leak

raiven.kao@gmail.com (Raiven Kao) — Sat, 17 Aug 2024 00:00:00 +0000

前言

某天下午，公司的 cronjob daemon 無預警的被 GCP OOM Kill 了，且程式碼沒有看出明顯的原因。

根據過去的經驗，local 開發時會使用 go tool pprof 來分析 CPU profile 或是 memory 與 trace 的問題，詳細可以參考 Go 官方文件。

由於我們的程式碼是一個基於 gin 的 http service，因此可以使用 gin 提供的 pprof 來快速建立 endpoint。

gin pprof

gin 的 pprof package 提供了數個基於 net/http/pprof 的 endpoint，可以分別為：

/: 基本的 pprof 的 static page，可以分析 CPU 與 memory 的問題。
/cmdline: 分析 command line 的問題。
/profile: 分析 CPU profile 的問題，可以透過 query string 來指定 CPU profile 的 duration。
/symbol: 分析 symbol table 的問題。
/trace: 分析 trace 的問題。
/goroutine: 分析 goroutine 的問題，這也是本文中重點查看的 endpoint。
/heap: 分析 heap 的問題。

可以在 http server 中加入以下程式碼來啟用 pprof：

從實務經驗重新認識 TLS

raiven.kao@gmail.com (Raiven Kao) — Sat, 22 Jun 2024 00:00:00 +0000

因為工作需要部署 grafana，重新認識了 TLS 的流程，藉此機會把學習過程紀錄下來。

主要分為理論與案例分享兩個大章節，理論章節主要是在講「應該要知道但學過就會忘」的內行，案例分享則為這一次部署 grafana 時的經驗分享。

理論

介紹

TLS 是什麼

TLS（Transport Layer Security，傳輸層安全協議）是用來保護互聯網通訊安全的協議。它能夠確保數據在互聯網上傳輸過程中的機密性、完整性和真實性。TLS 是從 SSL（Secure Sockets Layer）發展而來的，因此我們可能也可以把它稱為 SSL/TLS。

為什麼需要 TLS

在現代互聯網環境中，數據安全性變得至關重要。無論是電商、網路銀行或是社交平台，都需要確保用戶的機敏資訊不會被攔截或篡改。TLS 可以加密通訊內容，防止第三方竊聽，並且能驗證通訊雙方的身份，防止中間人攻擊（MITM）。

TLS 的應用場景

TLS 被廣泛應用於各種需要保護數據傳輸的場景，包括但不限於：

網站和應用程式的 HTTPS 通訊
電子郵件的加密傳輸（如 SMTPS、IMAPS、POP3S）
VPN 通訊
即時消息應用程式
各類雲服務和 API

TLS 基本概念

公鑰加密和私鑰加密

公鑰加密和私鑰加密是 TLS 的基礎。每個參與通訊的實體都擁有一對密鑰：公鑰和私鑰。公鑰是公開的，任何人都可以用來加密訊息，而私鑰是保密的，只有擁有者可以用來解密訊息。這樣的機制確保了即使加密訊息被攔截，也只有擁有私鑰的人能夠解密，細節可以回顧密碼學或計算機概論。

對稱加密和非對稱加密

對稱加密使用相同的密鑰來加密和解密數據，而非對稱加密則使用一對密鑰（公鑰和私鑰）。TLS 結合了這兩種加密方式：在握手階段使用非對稱加密來安全地交換對稱加密的密鑰，之後的通訊則使用對稱加密來提高效率。

數位證書和證書授權機構（CA）

數位證書是用來證明公鑰擁有者身份的電子文件，通常由證書授權機構（CA）簽發。證書包含公鑰、擁有者訊息以及 CA 的數字簽名。瀏覽器和其他應用程式可以驗證證書的真實性，確保通訊對象的身份。

數位證書的主要類型有：

域名驗證（DV）證書：僅驗證域名的所有權。
組織驗證（OV）證書：除了驗證域名，還驗證組織的合法性。
擴展驗證（EV）證書：提供最高級別的驗證，包括嚴格的身份檢查，瀏覽器地址欄顯示綠色的公司名稱。

TLS 的工作原理

握手過程（Handshake Process）

TLS 握手過程是建立安全連接的第一步，確保通訊雙方能夠安全地交換加密訊息。握手過程大致分為以下幾個步驟：

客戶端問候（Client Hello）：客戶端發送一個問候消息給伺服器，包含支持的 TLS 版本、加密算法、隨機數和其他必要訊息。
伺服器問候（Server Hello）：伺服器回應客戶端的問候消息，選擇一個加密算法，並發送伺服器的隨機數。
伺服器證書（Server Certificate）：伺服器發送其數位證書給客戶端，用於驗證伺服器的身份。證書包含伺服器的公鑰和由 CA 簽名的證書。
密鑰交換（Key Exchange）：伺服器和客戶端交換密鑰訊息，使用非對稱加密算法（如 RSA、ECDHE）安全地生成會話密鑰。這個會話密鑰將用於之後的對稱加密通訊。
加密通訊（Encrypted Communication）：客戶端和伺服器使用協商好的會話密鑰進行加密通訊。這確保了後續的數據傳輸是安全的。

以 TLS 1.3 的工作方式為例：

透過 throughput 與 latency 的關係解決高延遲問題

raiven.kao@gmail.com (Raiven Kao) — Sun, 16 Jun 2024 00:00:00 +0000

在軟體工程中，我們常會面臨服務 high latency 的問題，而要解決這個問題，理解 throughput 與 latency 的關係是關鍵。

名詞定義

什麼是 throughput 與 latency？

latency：處理一個請求需要花多少時間。從請求進來到回應出去的時間差。通常用毫秒 (ms) 來量測。越低越好。
throughput：單位時間內能處理多少請求。通常用 RPS (Requests Per Second) 或 QPS (Queries Per Second) 來表示。越高越好。

server 如何工作

server 接收請求後，由一個或多執行緒（threads）處理請求並生成回應。單執行緒 server 一次只能處理一個請求，而多執行緒 server 可以同時處理多個請求。

想像一下你的伺服器就是一家自助洗衣店。請求就像是帶衣服來洗的客人。

單執行緒的伺服器就像店裡只有一台洗衣機，一次只能服務一個客人。客人得排隊。多執行緒/多進程/異步 I/O 的伺服器就像有多台洗衣機，可以同時服務多個客人。

latency：從顧客開始操作洗衣機到洗衣完成的時間。這包括顧客等候空閒洗衣機的時間，以及實際洗衣的時間。等候時間越長，latency 越高。
throughput：洗衣店每小時完成的洗衣次數。洗衣機數量越多，洗衣店能處理的顧客數量越多，throughput 越高。

latency 與 throughput 的關係

很多人以為 latency 和 throughput 的關係是簡單的線性反比，或者覺得加機器就能解決一切。但現實更殘酷一點。

起初，當客人不多（請求量低）的時候，洗衣機（伺服器資源）很空閒，客人一來就能馬上洗，這時候 latency 很低，主要就是洗衣機本身運作的時間（我們稱之為 service time 或 true latency）。

隨著客人變多（請求量增加），洗衣機開始被佔滿。當所有洗衣機都在運作時，新來的客人就得排隊等了。這段等待時間就是 queueing latency。

Total Latency = Queuing Latency + Service Time

基於 Golang 的 Grafana Dashboard 與 JWT 認證的前後端實作

raiven.kao@gmail.com (Raiven Kao) — Mon, 10 Jun 2024 00:00:00 +0000

在工作上有一個需求是需要做一些 OLAP，原訂計畫是使用 Google Looker(ver. Google Cloud Core)，礙於量小不符合經濟效益，決定用 Grafana 這個較熟悉的開源套件來幫助我們做視覺化的處理。

這篇文章的範例可以在 omegaatt36/grafana-embed-example 中找到所有的 source code

我的 Use Case 為已經有一組 SHA512 產生的 Key，以下的內容為使用 HS512 進行簽名與認證。

流程

sequenceDiagram
    autonumber
    participant U as User
    participant B as Browser
    participant I as iframe
    participant S as Server
    participant G as Grafana

    rect rgb(236,239,244)
    U->>B: Open Web Page
    B->>S: Request JWT Token
    S->>B: Return JWT Token
    B->>I: Load iframe
    I->>G: Request Dashboard with JWT Token
    G->>I: Return Dashboard
    I->>B: Display Dashboard in iframe
    B->>U: Show Dashboard
    end

Grafana

配置

主要是針對 grafana.ini 做修改

從 vuepress 遷移到 hugo 的心得

raiven.kao@gmail.com (Raiven Kao) — Mon, 10 Jun 2024 00:00:00 +0000

前言

在網頁開發中，選擇合適的靜態網站生成器非常重要。過去我們使用 VuePress 來建立部落格網站，但在使用過程中遇到了一些痛點，最終決定遷移到 Hugo。本篇文章分享遷移過程中的一些心得。

當初選擇 VuePress 而非 Hugo 的原因

最初想要撰寫部落格時，已經有再 hugo 與 vuepress 間做選擇，當時覺得 hexo 與 hugo 實在是爛大街了，想要一些與眾不同的體驗。

選擇 VuePress 是基於以下幾點考量：

朋友推薦，他是一名資深前端工程師，是 vuepress core-team 成員。
僅需要撰寫 markdown，便能產生靜態的部落格。
使用 theme plugin，可以方便的美化部落格，僅需要專注在內容的撰寫，不需要操心部落格是不是白底黑字而已。

使用 VuePress 的痛點

起初我所使用的 theme plugin 為 vuepress-theme-reco(1.x)，並且搭配 vuepress 1.x 來進行建構。或是 vitepress，然而，在使用 VuePress 的過程中，我們也遇到了一些問題：

構建速度

我的部落格是無付費的使用 Netlify 進行託管，使用 vuepress 進行建構總是會花超過三分鐘，當進行 pr 的 preview build 時將會耗費大量的執行時間。

版本更新

過了一兩年，vuepress 官方開始推動 vuepress next(2.x)，vuepress-theme-reco 的作者也著手更新 next(2.x) 版本。期間從 alpha 版本到 beta 版本，當 vuepress 與 theme plugin 有 API 不同不的問題，就容易導致 build failed，這個情況到了 rc 版本也沒有改善。

使用內建的 rsync 備份 Truenas Scale 到 Proxmox Backup Server

raiven.kao@gmail.com (Raiven Kao) — Sun, 19 May 2024 00:00:00 +0000

前言

過去我會使用 backup script 配合 crontab 來定期的備份 nas 的資料，這次更換了 Proxmox Backup Server 的物理機後，多了一個硬碟的空間好讓我實驗 Truenas Scale 的備份機制。

差異

rsync 本身並沒有 server/client 的概念，只有 source 與 destination。過去我會在備份主機上透過 samba 來 mount Nas 到資料夾內，檢查有沒有 mount 成功才在備份主機上使用 rsync。而 Truenas Scale 提供的 Data Protection 功能中，內建了 Rsync Tasks 模組，透過預先建立好的 ssh credential 來呼叫備份主機進行 rsync。同樣都是由備份主機來進行 rsync，主要是任務的執行呼叫是 Truenas Scale 本身還是備份主基本身。

在 Truenas Scale 上建立備份任務

建立 SSH Pair

首先到 Credentials -> Backup Credentials 的頁面

點擊 SSH Configurations 中的 Add

用 testcontainers 在本地開發 Go 應用程式

raiven.kao@gmail.com (Raiven Kao) — Sun, 19 May 2024 00:00:00 +0000

介紹

使用 testcontainers 是在本地開發 Golang 應用程式的一個高效方式。這可以讓我們在不需要依賴外部環境的情況下，模擬應用程式在實際生產環境中的運行狀況。

安裝 testcontainers

在 Go 專案中，我們可以通過以下指令來導入 testcontainers

go get github.com/testcontainers/testcontainers-go

透過 Redis 實踐一個 rate limiter

package user

type Limiter struct {
    client *redis.Client

    limit         int
    limitPeriod   time.Duration // 1 hour for limitPeriod
    counterWindow time.Duration // 1 minute for example, 1/60 of the period
}

func NewLimiter(client *redis.Client, limit int, period, expiry time.Duration) *Limiter {
    return &Limiter{
        client: client,

        limit:         limit,
        limitPeriod:   period,
        counterWindow: expiry,
    }
}

func (r *Limiter) AllowRequest(ctx context.Context, key string, incr int) error {
    now := time.Now()
    timestamp := fmt.Sprint(now.Truncate(r.counterWindow).Unix())

    val, err := r.client.HIncrBy(ctx, key, timestamp, int64(incr)).Result()
    if err != nil {
        return err
    }

    if val >= int64(r.limit) {
        return ErrRateLimitExceeded(0, r.limit, r.limitPeriod, now.Add(r.limitPeriod))
    }

    r.client.Expire(ctx, key, r.limitPeriod)

    result, err := r.client.HGetAll(ctx, key).Result()
    if err != nil {
        return err
    }

    threshold := fmt.Sprint(now.Add(-r.limitPeriod).Unix())

    total := 0
    for k, v := range result {
        if k > threshold {
            i, _ := strconv.Atoi(v)
            total += i
        } else {
            r.client.HDel(ctx, key, k)
        }
    }

    if total >= int(r.limit) {
        return ErrRateLimitExceeded(0, r.limit, r.limitPeriod, now.Add(r.limitPeriod))
    }

    return nil
}

type RateLimitExceeded struct {
    Remaining int
    Limit     int
    Period    time.Duration
    Reset     time.Time
}

func ErrRateLimitExceeded(remaining int, limit int, period time.Duration, reset time.Time) error {
    return RateLimitExceeded{
        Remaining: remaining,
        Limit:     limit,
        Period:    period,
        Reset:     reset,
    }
}

func (e RateLimitExceeded) Error() string {
    return fmt.Sprintf(
        "rate limit of %d per %v has been exceeded and resets at %v",
        e.Limit, e.Period, e.Reset)
}

創建和啟動 Redis 容器

正式的產品通常會使用 config 來管理 Redis 位置，這個 demo 中直接使用 localhost:6379 來展示。

透過 Distrobox 解決 Linux 環境依賴問題

raiven.kao@gmail.com (Raiven Kao) — Sat, 18 May 2024 00:00:00 +0000

前言

自從一年前嘗試使用 KDE Neon 後，主要的桌面開發環境就從 wsl 整個遷移到 Linux 上。這一年來感受到，KDE Neon 可能正如 reddit 上的留言闡述的那樣，只是 KDE 團隊的「實驗場」，可以享受到「最」新的 Plasma 與「較」新的 Kernel，卻始終是基於 Ubuntu 22.04 LTS，即便 Ubuntu 24.04 LTS 推出之際，也不再讓我感受性感。

因緣際會，在 Ubuntu 24.04 LTS 發布之際，我決定從 KDE Neon distro hopping 到 OpenSUSE Tumbleweed，這是一個由 SUSE 公司推出的滾動式發行版，軟體包在 SUSE 測試過後便會推送到 OpenSUSE 的 Repo（其他 OpenSUSE 的功能省略）。這次的轉換主要是為了獲得最前沿的 Linux 體驗。OpenSUSE Tumbleweed 的滾動更新模式能確保我始終使用最新的軟體和技術，這對我來說是一個有趣的選擇，即便有可能收到有問題的 xz 更新 XD。

❯ fastfetch
                                     ......             raiven@raiven-suse
     .,cdxxxoc,.               .:kKMMMNWMMMNk:.         ------------------
    cKMMN0OOOKWMMXo. A        ;0MWk:'      ':OMMk.      OS: openSUSE Tumbleweed 20240517 x86_64
  ;WMK;'       'lKMMNM,     :NMK'             'OMW;     Host: FMV UH-X
 cMW;             WMMMN   ,XMK'                 oMM.    Kernel: 6.8.9-1-default
.MMc             ''^*~l. xMN:                    KM0    Uptime: 1 hour, 14 mins
'MM.                   .NMO                      oMM    Packages: 3211 (rpm), 37 (flatpak)
.MM,                 .kMMl                       xMN    Shell: zsh 5.9
 KM0               .kMM0' .dl>~,.               .WMd    DE: KDE Plasma 6.0.4
 'XM0.           ,OMMK'    OMMM7'              .XMK     WM: KWin (Wayland)
   *WMO:.    .;xNMMk'       NNNMKl.          .xWMx      WM Theme: Nordic
     ^ONMMNXMMMKx;          V  'xNMWKkxllox0NMWk'       Theme: Breeze (NordicDarker) [QT], Breeze-Dark [GTK2], Breeze [GTK3]
         '''''                    ':dOOXXKOxl'          Icons: Zafiro-Nord-Dark-Black [QT], Zafiro-Nord-Dark-Black [GTK2/3/4]
                                                        Font: Noto Sans (10pt) [QT], Noto Sans (10pt) [GTK2/3/4]
                                                        Cursor: Nordic (24px)
                                                        Terminal: tmux 3.4
                                                        CPU: 13th Gen Intel(R) Core(TM) i5-1335U (12) @ 4.60 GHz
                                                        GPU: Intel Iris Xe Graphics @ 1.25 GHz [Integrated]
                                                        Memory: 9.86 GiB / 15.27 GiB (65%)
                                                        Swap: 677.00 MiB / 2.00 GiB (33%)
                                                        Disk (/): 88.81 GiB / 1.82 TiB (5%) - btrfs

即便是已經足夠穩定的 OpenSUSE，也是可以很輕易的被搞的不穩定，正如 debian 在 DontBreakDebian 一文中提到的：

如何不啟動 container 從 image 中提取可執行檔

raiven.kao@gmail.com (Raiven Kao) — Sun, 14 Apr 2024 00:00:00 +0000

::: info 雖然文章內大多指令都是使用 docker，但由於是標準的 OCI image，使用 Podman 也是一樣的效果。 :::

某段時間內，我會將所有需要執行的 binary 使用 containerize 給打包起來執行，例如：

需要將前端環境給跑起來，我會啟動一個 node 環境的 container:

docker run --rm -it --name f2e --net=host -v $(pwd):/app \
    docker.io/library/node:20-bookworm \
    bash

需要安裝某個基於 golang 的 cli 工具，會使用自己寫的腳本，在 container 內進行建構。
需要透過 Liquibase 來進行 db migration，並不會選擇在本地安裝 maven 環境，一樣是啟動一個 container 來執行。

這麼做的好處是，「目前」大多數的 server/cli tools 至少會編譯 x86 架構下的可執行檔，我只需要確保 container 環境內可以工作，就可以在不同硬體的開發環境下游走。極度偏激的來說，無法確保安裝的 binary 有沒有受過污染，無論開源或閉源與否，也可以透過 Podman 來啟動 rootless 的 container 確保本機的安全。

但有時候會遇到別人打包的 image 十分肥大，即便程式可執行檔只需要幾 MB，編譯後的 image 確有幾百 MB（大多數是腳本語言），蒙生了從 image 中提取 executable 的想法，藉此也學習 docker layer 間的關係。

如何利用 Open Policy Agent 配合 Golang 建構彈性的 RBAC 模組

raiven.kao@gmail.com (Raiven Kao) — Thu, 04 Apr 2024 00:00:00 +0000

RBAC 概念簡介

在我們探討如何利用 Open Policy Agent (以下簡稱 OPA) 和 Golang 建立一個彈性的 RBAC 模組之前，先讓我們來了解一下 RBAC的基本概念。

RBAC（Role-Based Access Control，基於角色的訪問控制）是一種廣泛應用的訪問控制策略，在軟體安全性領域尤為重要。其核心思想是將系統訪問權限與用戶的角色（職位、責任或職務）關聯起來，而不是直接與個別用戶關聯。這意味著訪問權限被捆綁到角色上，然後將用戶分配給這些角色。舉個例子，一個「管理員」角色可能有權訪問系統的所有資源，而「員工」角色則只能訪問特定部分的資源。

RBAC 的主要優勢在於其靈活性和簡化的權限管理。當需要變更權限時，只需修改角色的訪問權限，而不需要為每個用戶單獨設定。這不僅使權限管理更為高效，也減少了錯誤配置的可能性，提高了整體的系統安全性。

在實踐中，RBAC 允許創建精細且靈活的策略，以滿足複雜的商業和安全需求。無論是大型企業還是小型團隊，RBAC 都提供了一個可靠的框架，來確保正確的用戶擁有適當的訪問權限，從而保護關鍵資源免受未授權訪問。

可以參考 Cloudflare 的文章，簡單來說就是什麼「角色」能夠對什麼「資源」做什麼「操作」。

Open Policy Agent (OPA) 介紹

OPA 是一個「Strategy as Code」的開源專案，專門設計用於統一地管理和執行跨不同系統的策略。它不僅提供了一個高級的策略語言——Rego，還支援將策略作為代碼與應用程式的其他部分一同存儲、版本控制和部署。OPA 的這種設計使其能夠輕鬆集成到微服務、Kubernetes、CI/CD 管道、API 網關等多種環境中。顯著特點是其策略的編寫方式。Rego 是一種專門為策略和規則定制的查詢語言，它使開發者能夠以聲明式方式描述策略和規則，從而確保這些策略既容易理解又易於維護。這對於建立複雜的 RBAC 系統尤為重要，因為它允許策略的靈活性和可擴展性，同時又保持了清晰和易於審查的結構。

我們可以利用 OPA 提供的 API 來評估和執行這些策略。這意味著開發者可以在 Golang 程式碼中直接嵌入策略判斷的邏輯，從而實現動態、細粒度的訪問控制。這種方法的一個優點是，它支援在 runtime 動態更新策略，或是編譯進 binary，從而提供更大的靈活性和即時性。

整合 OPA 與 Golang

透過官方案例來了解如何使用

參考了 OPA 官方的 rbac 章節，並加以修改。使用最簡單的例子：

admin can read user
bob is admin
-------------------
bob can read user

轉化成 RBAC 模型即為：

Agile Testing 閱讀筆記

raiven.kao@gmail.com (Raiven Kao) — Sun, 24 Mar 2024 00:00:00 +0000

鋪墊：敏捷開發價值觀、原則與實踐

有什麼開發，就有什麼測試，傳統開發就有傳統測試，敏捷開發就應該要推行敏捷測試。在討論敏捷測試前，應該先理解敏捷開發模式，否則理解敏捷測試會很困難。

敏捷開發是一種思想或稱作方法論，通過不斷迭代與增量發布，最終交付符合用戶價值的產品。

書中提到一些敏捷開發的歷史、演進與框架

PDCA 循環
輕量級軟體開發減少複雜的文件，強調人員的互動
敏捷宣言
XP（eXtreme Programing）：較多是著重在軟體開發，例如 TDD、pair programing、CI 等等。
BDD（行為驅動開發）：使用「通用語言」來描述測試案例，將 User Story 的細節進行完整地描述。 Feature（特性）: 購物車功能 Scenario（情境）: 添加商品到購物車
- Given（假設）: 用戶已經登錄到購物平台並且正在瀏覽商品
- When（當）: 用戶點擊某個商品的「添加到購物車」按鈕
- Then（那麼）: 該商品應該被添加到用戶的購物車中
- And（並且）: 購物車中的商品總數應該更新
FDD（特性驅動開發）：使用制式結構來建構特性列表

<action> the <result> <by|for|of|to> a(n) <object>

Scrum：確保每天、每個階段都向著目標明確進行的一種「方法」。推薦看 Scrum 提倡者自己寫的 SCRUM：用一半的時間做兩倍的事

DevOps 與敏捷的關係

DevOps 可以看作是敏捷的延伸，打通軟體開發、測試、交付、維護中的層層牆壁。

敏捷宣言

藉著親自並協助他人進行軟體開發，我們正致力於發掘更優良的軟體開發方法。透過這樣的努力，我們已建立以下價值觀：

個人與互動重於流程與工具
可用的軟體重於詳盡的文件
與客戶合作重於合約協商
回應變化重於遵循計劃

也就是說，雖然右側項目有其價值，但我們更重視左側項目。

敏捷測試之道

敏決測試不是一種測試方法，而是為了適應敏捷開發而設計的一套軟體測試解決方案。

敏捷測試宣言

Full Lifecycle Testing OVER Isolated Testing Phase
Team Shared Responsibility OVER Testers Ensure Quality
Continuous Targeted Automation OVER Widespread Regression Testing
Quality Built-in OVER Defect Detection

Full Lifecycle Testing

強調測試左移與右移，並非將測試「移動」到兩個端點，而是全程測試的介入。

那些在 Backend Sharing 中出現的人事物

raiven.kao@gmail.com (Raiven Kao) — Sun, 24 Mar 2024 00:00:00 +0000

《最高學以致用法》、《最高學習法》這兩本書是我在 2023 年上半年讀了覺得挺有意思的書，核心概念就是「產出」，例如唸書時能夠回答同學問題的，肯定都已經精通該知識點了。

加入 KryptoGO 後，因為團隊的成長，Leader 開始嘗試舉行兩週一次的 Backend Sharing，不僅是分享工作上遇到的疑難雜症，更可以交流不同的知識點。

起初，我可以我分享了一些過去用過的工具與知識點，隨著時間的流逝，開始感受到黔驢技窮，於是我也仿效了《刻意練習》，不斷的為了能有更好的分享品質而學習。

以下是這半年來我在 Backend Sharing 中或多或少提及或是討論到的，又分為解決方案、小工具、方法論。

小工具

由於喜歡折騰 Homelab，時不時會到 r/selfhosted、r/opensource/ 尋找一些開源的自架方案或小工具，有一些大幅度的改善了我的開發流程，而有一些則漸漸的不再使用

exa & eza & bat

eza、exa、bat 都是基於 rust 寫成的 cli 替代品，exa、eza 對標 cd，而 bat 對標 cat，我會在 .zshrc 中寫上 alias。

if command -v bat &> /dev/null; then alias cat=bat; fi
if command -v eza &> /dev/null;
then
  alias ls="eza --icons"
  alias ll="eza --icons -lh"
  alias tree="eza --icons --tree"
fi

還有其他性質相同的 rust 寫的小工具諸如： zoxide、topgrade、alacritty、bottom

透過 CLI 調整藍牙耳機音訊設定

raiven.kao@gmail.com (Raiven Kao) — Sun, 28 Jan 2024 00:00:00 +0000

接續著 KDE neon / Ubuntu 啟用 PipeWire 與 LDAC/AAC/AptX 藍芽編碼，每當連線到藍芽耳機時，語音設定檔在使用 LDAC 後，就無法同時使用麥克風，這樣一來在開會時，就需要手動到設定裡面去調整語音設定檔。

身為一個懶惰鬼，可以用鍵盤解決的就不會用滑鼠去點，發現可以通過 pactl（PulseAudio）在 cli 直接設定 audio profile。

首先，我們通過 bluetoothctl 列出藍芽設備的實體位置

$ bluetoothctl
> [EAH-A800]# devices
> Device 88:C9:E8:B1:5D:AE WF-1000XM4
> Device DC:22:D2:85:85:15 MX Master 3S
> Device B8:20:8E:35:CB:D0 EAH-A800

文章內舉例的目標為 EAH-A800，也就是 B8:20:8E:35:CB:D0 接著需要確認目前藍牙裝置支持的音訊設定檔。可以透過 pactl list cards short 來列出目前啟用的設備

$ pactl list cards short
47      alsa_card.usb-Shure_Inc_Shure_MV7-00    alsa
48      alsa_card.pci-0000_00_1f.3-platform-skl_hda_dsp_generic alsa
49      alsa_card.usb-NuPrime_NuPrime_DAC-9H-00 alsa
1002    bluez_card.B8_20_8E_35_CB_D0    module-bluez5-device.c

發現目標為 1002 bluez_card.B8_20_8E_35_CB_D0 再來通過 pactl list cards 來獲取所有音訊設定檔

Golang 隱式記憶體別名 Implicit Memory Aliasing 與其檢測方法

raiven.kao@gmail.com (Raiven Kao) — Sun, 12 Nov 2023 00:00:00 +0000

在使用 Golang 時，我們可能會遇到一種稱為隱式記憶體別名（Implicit Memory Aliasing）的問題。這篇文章將探討這個問題以及如何使用工具和語言特性來解決它。

隱式記憶體別名的問題

隱式記憶體別名主要發生在 range 語句中。當使用 range 對一個切片 slice 或映射 map 進行迭代時，Iterator 在每次迭代中並不是唯一的實例。這可能導致意外的行為，特別是在並發環境或當迭代變量被指針引用時。

slice with Implicit Memory Aliasing

下面示例可能是基本的 golang 面試題，會問你迭代後的 pointers 內的 Name 為何答案是 Joe Joe Joe

package main

import "fmt"

type Person struct {
	Name   string
	Gender string
}

func main() {
	persons := []Person{
		{Name: "John", Gender: "M"},
		{Name: "Jane", Gender: "F"},
		{Name: "Joe", Gender: "X"},
	}

	pointers := make([]*string, len(persons))
	for index, person := range persons {
		fmt.Printf("%p, %p, %p, %v\n", &person, &person.Name, &person.Gender, &persons[index].Name)
		pointers[index] = &person.Name
	}

	for index := range pointers {
		fmt.Println(pointers[index], *pointers[index])
	}
}

channel with Implicit Memory Aliasing

同樣的情況也會發生在 channel 的迭代。

透過 frp 與 GCP 打通家用 kubernetes cluster 的對外連線

raiven.kao@gmail.com (Raiven Kao) — Sun, 12 Nov 2023 00:00:00 +0000

概述

在家裡面架著一台 lab，使用 proxmox ve 作為 vm server 透過 qemu 虛擬化一台 ubuntu server vm 在這個 vm 上使用 k3s，啟動 kubernetes 的服務在 kubernetes 內跑著眾多 dockerize 的 containers。

雖然我不是資深維運專家，但我知道這可能很搞笑。

會需要這麼麻煩還不是為了省一點點 GKE 的成本（即便可能沒省到），但在自家建一個 lab 環境而不用計算由時間計價的 infra 成本，還是挺省腦袋的。

過去僅是將 service 使用 nodePort 來讓家裡面的其他裝置可以連線，或是使用 wireguard 作為 VPN 來從遠端連線，就是沒有動力處理好 http service 與 TLS，趁這個假日剛好需要把自架 vaultwarden 後端給 expose 出來，便誕生了這篇。

在當前的雲端運算時代，許多開發者和 IT 專業人員都面臨著一個共同的挑戰：如何有效地將位於不同網絡環境中的服務整合並暴露給公眾。特別是對於那些希望將家用網絡中的服務有效連接到公共雲端（如 GCP,AWS,Azure,OCI）的用戶來說，這一挑戰尤為突出。文內主要講述通過在 GCP VM 上部署 FRP（Fast Reverse Proxy）服務器，結合家中的 kubernetes cluster 上配置的 FRP 客戶端，來實現一個高效且安全的服務部署流程。

透過此方式，我們不僅可以利用 GCP VM 作為公共 IP 的代理，實現從互聯網到家庭網絡的無縫連接，還能藉助 kubernetes 的強大功能進行快速的服務部署和管理。同時，利用 ingress-nginx 作為 ingress 控制器和 cert-manager 進行 TLS 設定，我們能夠確保服務的安全性和可靠性。

KDE neon / Ubuntu 啟用 PipeWire 與 LDAC/AAC/AptX 藍芽編碼

raiven.kao@gmail.com (Raiven Kao) — Sun, 01 Oct 2023 00:00:00 +0000

Ubuntu 22.10 將 Audio Server 從 PulseAudio 切換成 PipeWire

遇到了什麼問題

明明使用著有 LDAC 或是 AptX 解碼能力的藍芽耳機，卻只能被迫接受 sbc 的低傳輸率音質嗎，身為規格黨怎麼可以忍受這件事（即便大部份時間都只使用 Youtube Music 的 128K bps opus）

解決方法

我們可以在 KDE neon 上啟用 PipeWire，並安裝更多藍芽轉碼器

安裝 WirePlumber（PipeWire Manager）

sudo apt install -y pipewire-media-session- wireplumber

透過 systemd 管理 WirePlumber 的開機自啟 daemon
```
systemctl --user --now enable wireplumber.service
```

安裝 ALSA

sudo apt install -y pipewire-audio-client-libraries

安裝藍芽轉碼器

sudo apt install -y \
    libfdk-aac2 \
    libldacbt-{abr,enc}2 \
    libopenaptx0
sudo apt install -y \
    libspa-0.2-bluetooth \
    pipewire-audio-client-libraries \
    pipewire-pulse

解除安裝 PulseAudio

sudo apt remove -y pulseaudio-module-bluetooth

登出或重新啟動

檢查成果

❯ LANG=C pactl info | grep '^Server Name'
Server Name: PulseAudio (on PipeWire 0.3.48)

成效

讓耳機連線至電腦後，選擇設定檔會出現更多轉碼器，諸如 SBC 與 LDAC，但若訊源只是普通串流，那其實聽起來不太可能會有差異。

使用 wireguard 與 aws 搭建虛擬內網

raiven.kao@gmail.com (Raiven Kao) — Sun, 01 Oct 2023 00:00:00 +0000

先前在「在 AWS 上使用 EC2 建立 FRP 玩玩內網穿透」一文中敘述了如何透過 AWS 實現虛擬穿透，也在內文中提到或許可以使用 wireguard 搭建內網，其原因也很簡單：每更新一個 port 都要重新設定 server side 實在是太麻煩了，拖更了進一年終於要開始寫 wireguard 的使用了。（AWS 免費也快到期了）

遇到了什麼問題

在使用 wireguard 來搭建 VPN 前，我是使用 zerotier 搭配 Mikrotik RB5009 所執行的 RouterOS 7.x 版本，讓外網可以連回家裡的網路環境

但 zerotier 的網路拓樸是存在他們官方伺服氣上，與其相信 zerotier，我想在 vps 上建立虛擬機，並只許特定 ip 登入，可能更加可靠（？

解決方法

於是我在 frp tunnel VM 上建立了 wireguard 節點，作為外網與內網溝通的橋樑。

wireguard 是一個高效的現代化 VPN，目標是比 IPsec 更快。在 2020 年時正式推出 1.0.0 版本。

wireguard 的拓樸實際上是 peer2peer，甚至可以達到 full mesh，但礙於錢錢不夠，單一個節點作為 server side 就足夠了。

server

使用 docker-compose 能快速部署 wireguard 服務，我們使用的是 wg-easy 簡單換掉一些參數:

透過 WakaTime 幫助來紀錄自己做了哪些事，並製作獨特的 GitHub Profile

raiven.kao@gmail.com (Raiven Kao) — Thu, 03 Aug 2023 00:00:00 +0000

WakaTime 介紹

WakaTime 是一款紀錄自己生產力的工具，透過客戶端插件、集成工具紀錄「行徑」並發送到官方｜非官方伺服器，可以分析花了多久時間在哪個專案、哪個程式語言、會議、code review。

記憶力不佳，過去常常無法想起某段時間做了哪些專案，甚至 daily standup 前忘記昨天做了什麼，發現了 wakatime 可以透過 vscode 插件、terminal 插件來查看自己在哪些時間變更了哪些專案、檔案，甚至可以紀錄下過得指令（僅 binary 的部份，不含參數不會洩漏資料）。

在使用 WakaTime 前，先到 WakaTime 官網上註冊並登入，取得最重要的 API Key(API Token)：

安裝相應的客戶端插件。wakatime 支援的插件、編輯器包括但不限於：

Visual Studio Code
Vim
Excel
Terminal
- zsh
- bash
- fish
- iTerm2

舉例來說我們可以安裝 vscode 插件，並跟著 Installation 輸入完 API Key 就可以開始寫點東西了。

查看報告

使用了一段時間後，可以回到官網查看 dashboard

查看自己上週、前兩週、前一個月每天花了（浪費）了多少時間，以前三十天的圖為例：

或是 YoY 的活動圖

以此 blog 的 repo 來作為舉例，可以查看某個 project 的細節

在該專案花了多少時間、什麼語言：

檔案、分支的時間分配：

費用

免費版本的功能已經十分完整了，完整費用方案在此。透過學生帳號可以申請教育折扣，年度付費 Premium 方案的話一年只要 59 美元，就可以享有完整的 WakaTime 服務。雖然付費方案的功能幾乎都可以透過免費版本就有的 API 來完成，但仍可以花點小錢支持團隊，或是開啟公司計畫。

KDE Neon 使用心得與踩雷紀錄

raiven.kao@gmail.com (Raiven Kao) — Sun, 04 Jun 2023 00:00:00 +0000

前言

年初為了 arc browser 裝了一台 Hackintosh，因為原因又花了點時間裝了 KDE Neon，這邊紀錄一下使用心得與踩雷紀錄。時間線大概是

快快樂樂使用 wsl2
wsl 中踩了不少坑，想要嘗試 unix liked 的系統
好心人提供 arc browser 的邀請，萌生了裝 Hackintosh 的念頭
- 在 HP Z2 G4 上裝了 Hackintosh，但是沒有事前做足功課，內顯圖形記憶體(P630)始終是 7mb
- 買了張 amd WX4100 督上去，大幅提昇圖形性能，卻也沒再花時間繼續深入
嘗試在 windows 主機上雙系統 (windows + linux):
- 一開始直接選擇熟悉的 ubuntu，安裝了 ubuntu desktop 版本，由於是 nvidia 顯示卡，很快的遇到了硬體解碼問題
- 開始嘗試 nvidia-vaapi-driver，但是遇到了很多問題，最後放棄
- 想換到 amd 顯示卡，但是又不想花錢，於是想說看看其他發布版是否能解決
- 從 Linux Mint, Manjaro, KEO Neon 中選擇了同樣是 ubuntu 底，卻是 KDE 團隊維護團隊的 KDE Neon
- 不出意外的一樣遇到了 nvidia 驅動問題，雖然 firefox 已經可以順利硬體加速，但是 chromium 等仍然無法硬體加速
- 這時候已經花了不少時間在這個問題上，於是決定換到 amd 顯示卡(內顯)
- 在 Minisforum UM560 上安裝了 KDE Neon，一切順利，驅動毫無問題，硬體加速也正常
- 嘗試裝了 ventura theme，讓他稍微好看一點
持續與 wayland 相處，走一步是一步…

❯ neofetch
             `..---+/---..`                raiven@um560
         `---.``   ``   `.---.`            ------------
      .--.`        ``        `-:-.         OS: KDE neon 5.27 x86_64
    `:/:     `.----//----.`     :/-        Host: UM560
   .:.    `---`          `--.`    .:`      Kernel: 5.19.0-43-generic
  .:`   `--`                .:-    `:.     Uptime: 1 hour, 2 mins
 `/    `:.      `.-::-.`      -:`   `/`    Packages: 1924 (dpkg), 4 (snap)
 /.    /.     `:++++++++:`     .:    .:    Shell: zsh 5.8.1
`/    .:     `+++++++++++/      /`   `+`   Resolution: 2560x1440
/+`   --     .++++++++++++`     :.   .+:   DE: Plasma 5.27.5
`/    .:     `+++++++++++/      /`   `+`   WM: kwin
 /`    /.     `:++++++++:`     .:    .:    Theme: [Plasma], Colloid-Dark [GTK2/3]
 ./    `:.      `.:::-.`      -:`   `/`    Icons: Cupertino-Ventura [Plasma], Cupertino-Ventura [GTK2/3]
  .:`   `--`                .:-    `:.     Terminal: konsole
   .:.    `---`          `--.`    .:`      CPU: AMD Ryzen 5 5625U with Radeon Graphics (12) @ 2.300GHz
    `:/:     `.----//----.`     :/-        GPU: AMD ATI 04:00.0 Barcelo
      .-:.`        ``        `-:-.         Memory: 6265MiB / 31519MiB
         `---.``   ``   `.---.`
             `..---+/---..`

Post Install KDE Neon

解決 key 過舊

當使用 sudo apt update 時可能會發生

golang 樂觀鎖、悲觀鎖學習筆記與實驗

raiven.kao@gmail.com (Raiven Kao) — Sun, 14 May 2023 00:00:00 +0000

介紹

改變數值的三個步驟

取出
修改
保存

但這三者間的時間差在不同 process、不同 thread、不同 corutine/goroutine 中會造成競爭危害(race condition)。

可以使用多種發法確保並行(concurrency)處理時保持資料的一致性，這裡介紹的是最常使用的悲觀鎖與樂觀鎖。

悲觀鎖: 總可能發生問題

lock
(1) 取值
(2) 修改
(3) 保存
unlock

樂觀鎖: 不會總是發生問題

(1) 取值
if *addr == old {
    (2) 修改
    (3) 保存
    return true
}
return false

悲觀鎖

golang 中主要使用 sync.Mutex 作為悲觀鎖，看似會阻塞住其他 goroutines，但其實 sync.Mutex 中也使用到了 CAS。

sync.Mutex 中有一個 int32 的 state 與 uint32 的 sema(semaphore)

type Mutex struct {
	state int32
	sema  uint32
}

const (
	mutexLocked = 1 << iota // mutex is locked
	mutexWoken
	mutexStarving
	mutexWaiterShift = iota
    starvationThresholdNs = 1e6
)

func (m *Mutex) Lock() {
	if atomic.CompareAndSwapInt32(&m.state, 0, mutexLocked) {
		if race.Enabled {
			race.Acquire(unsafe.Pointer(m))
		}
		return
	}
	m.lockSlow()
}

state:

讓 BOOX 也使用繁體中文辭典

raiven.kao@gmail.com (Raiven Kao) — Thu, 04 May 2023 00:00:00 +0000

由於最近讀原文書讀得挺辛苦，邊用電子閱讀器看書，騰不出手用手機查字典，內建的辭典又只有英文翻譯簡體中文，在網上衝浪也找不到繁體中文的 mdx 英漢辭典可以直接使用。

所需依賴

任何英漢辭典

文內以 BOOX 內下載的英漢辭典，參考教學。
python 環境，用以安裝 mdict-utils

經測試後 windows 與 wsl 中均能完成，文內 python 環境以 wsl 為主。
任何繁簡轉換軟體

文內以新發現的 ConvertZZ 最為 GUI 簡轉繁示例。文末有使用 OpenCC 作為 CLI 示例。

主要流程

將 mdx 拆成 txt
簡轉繁
將 txt 包成 mdx

安裝

安裝 mdict-utils

❯ pip install mdict-utils
Defaulting to user installation because normal site-packages is not writeable
Collecting mdict-utils
  Downloading mdict_utils-1.3.12-py3-none-any.whl (36 kB)
Collecting xxhash
  Downloading xxhash-3.2.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (212 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 212.5/212.5 KB 1.6 MB/s eta 0:00:00
Collecting tqdm
  Downloading tqdm-4.65.0-py3-none-any.whl (77 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 77.1/77.1 KB 7.4 MB/s eta 0:00:00
Installing collected packages: xxhash, tqdm, mdict-utils
Successfully installed mdict-utils-1.3.12 tqdm-4.65.0 xxhash-3.2.0

unpack

將英漢辭典重新命名為 dict.mdx

如何優雅地批次安裝 Nerd font 字型

raiven.kao@gmail.com (Raiven Kao) — Wed, 03 May 2023 00:00:00 +0000

fonts repo

接觸 wsl/ubuntu 的這幾年，經常會需要安裝 zsh 以及字型，因此誕生了 cheat sheet，久而久之連下載->解壓縮->安裝這個過程，都懶了。

於是寫了一個批次下載並安裝最新版本的 Nerd Fond 字型的 shell script，讓 wsl 可以安裝 windows 的字型，linux 可以安裝 linux 字型。

#!/bin/bash

declare target="linux"
declare repo="ryanoasis/nerd-fonts"
declare -a fonts=(
  BitstreamVeraSansMono
  CodeNewRoman
  DroidSansMono
  FiraCode
  FiraMono
  Go-Mono
  Hack
  Hermit
  JetBrainsMono
  Meslo
  Noto
  Overpass
  ProggyClean
  RobotoMono
  SourceCodePro
  SpaceMono
  Ubuntu
  UbuntuMono
)


ARGS=`getopt -o p --long windows -- "$@"`
if [ $? -ne 0 ]; then
  echo "getopt failed: " $ARGS
  exit 1
fi

eval set -- "${ARGS}"

while true
do
case "$1" in
  -p|--windows)
    target=windows
    shift
    ;;
  --)
    shift
    break
    ;;
esac
done


get_latest_release() {
  echo $(curl --silent "https://api.github.com/repos/$@/releases/latest" |
    grep '"tag_name":' |
    sed -E 's/.*"([^"]+)".*/\1/')
}

function install_linux_fonts() {
  local fonts_dir
  fonts_dir="${HOME}/.local/share/fonts"
  if [[ ! -d "$fonts_dir" ]]; then
    mkdir -p "$fonts_dir"
  fi
  mv $@/*.ttf $fonts_dir/

  # fc-cache -fv
}

# Install font for the current user. It'll appear in "Font settings".
function install_windows_fonts() {
  local dst_dir
  dst_dir=$(wslpath $(cmd.exe /c "echo %LOCALAPPDATA%\Microsoft\\Windows\\Fonts" 2>/dev/null | sed 's/\r$//'))
  mkdir -p "$dst_dir"
  local src
  for src in "$@"; do
    local file=$(basename "$src")
    test -f "$dst_dir/$file" || cp -f "$src" "$dst_dir/"
    local win_path
    win_path=$(wslpath -w "$dst_dir/$file")
    echo $win_path
    reg.exe add                                                      \
      "HKCU\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Fonts" \
      /v "${file%.*} (TrueType)"  /t REG_SZ /d "$win_path" /f 2>/dev/null
  done
}

function main() {
  local version
  version=$( get_latest_release $repo )
  local tmp_dir
  tmp_dir="$(mktemp -d)"

  trap "rm -rf ${tmp_dir@Q}" INT TERM EXIT

  for font in "${fonts[@]}"; do
    zip_file="${font}.zip"
    download_url="https://github.com/$repo/releases/download/${version}/${zip_file}"
    echo "Downloading $download_url"
    wget -q --show-progress -P "$tmp_dir" "$download_url"
    # unzip -o means replace file without asking.
    unzip -o "$tmp_dir/$zip_file" -d "$tmp_dir"
    rm "$tmp_dir/$zip_file"
  done
  find "$tmp_dir" -name '*Windows Compatible*' -delete

  if [ "$target" = "linux" ]
  then
    install_linux_fonts $tmp_dir
  elif [ "$target" = "windows" ]
  then
    install_windows_fonts $tmp_dir/*.ttf
  fi
}

main

echo -e '\033[0;32m'
echo 'Fonts successfully installed.'
echo -e '\033[0m'

若沒有要改目標字型也可以直接透過 github 上的檔案來安裝

golang 中使用 Line LIFF 實作 Single Sign-On

raiven.kao@gmail.com (Raiven Kao) — Sat, 22 Apr 2023 00:00:00 +0000

文章中的程式碼放在https://github.com/omegaatt36/line-verify-id-token中。

Requirements

Line Login Channel
- channel id
- channel secret
Line LIFF APP
- 用 liff.getIDToken() 獲取 ID Token

在現代網站中，單一登錄 (Single Sign-On, SSO) 已經成為了一個普遍存在的功能，它能夠讓使用者在不同的應用程式和服務之間自動地登錄，而不需要再輸入帳號和密碼。這樣可以方便使用者的使用，並且也能夠增加安全性，減少帳號密碼被盜用的風險。

我們將使用 Golang 語言來實作單一登錄功能，並且使用 Line LIFF 來進行身份驗證。在此之前，我們需要先了解幾個概念。

Line LIFF (Line Front-end Framework) 是一個由 Line 提供的 Web 應用程式框架，開發者可以使用它來建立 Line 的客戶端應用程式。使用 Line LIFF 開發的應用程式可以在 Line 客戶端中被直接執行，而不需要額外安裝或下載。此外，Line LIFF 還提供了一些功能，例如使用者的身份驗證、分享資料等等。

JWT (JSON Web Token) 則是一種開放標準，用於在不同系統之間安全地傳輸訊息。它通常用於認證和授權，因為它可以確保傳輸的訊息是可信的，而且在傳輸過程中不會被竄改。

我們可以使用 Line 的 Verify API，同時也可以選擇後端自己驗證，解出 jwt 中的資訊。

我們的目的是拿到每個使用者在 Line 的 UserID，做為身分識別。於是根據 Line 提供的 JWT 欄位對應，定義一個結構用來存放驗證後的資訊。

// DecodedIDToken defines decoded payload by id token.
type DecodedIDToken struct {
	Amr       []string
	ChannelID string
	Email     string
	ExpiredAt int64
	IssuedAt  int64
	Issuer    string
	Name      string
	Picture   string
	UserID    string
}

接著撰寫一個驗證 ID Token 的 function 用來驗證

跟風寫了個使用 OpenAI API 的 Telegram Chat Bot

raiven.kao@gmail.com (Raiven Kao) — Fri, 17 Mar 2023 00:00:00 +0000

前言

放在最前面 Github repo

原本打算使用別人寫好的 bot，免費的版本均是透過儲存 cookies 的方式，直接透過 ChatGPT 網頁建立新的「Chat」。好景不常，OpenAI 馬上把登入頁面到聊天頁面中間安插了類似 reCaptcha，來驗證是否為真人。看到有好心人提供了 go 版本的 OpenAi API，就打算自己寫一寫，順便當作《Clean Architecture》的讀後作業。

依賴注入

~~架構圖待補~~

我需要對 OpenAI 詢問，並用 stream(逐字)的方式回給我，也需要對 Telegram 逐字回答。

在這個 8931bf 版本中，很明確定義對於 OpenAI 與 Telegram 的 usecase

chatgpt_usecase.go

// ChatGPTUseCase defines ChatGPT send question use case.
type ChatGPTUseCase interface {
	Stream(ctx context.Context, question string) (<-chan string, <-chan error)
}

telegram_usecase.go

// TelegramUseCase defines telegram send message use case.
type TelegramUseCase interface {
	SendAsLiveOutput(chatID int64, feed <-chan string) error
}

在 *_repository.go 進行實作。並在 main.go 中依賴反轉，將實作注入近 bot service。

Logitech Media Server 遷移紀錄：從 Bare Metal 到 Docker 再到 Podman

raiven.kao@gmail.com (Raiven Kao) — Fri, 24 Feb 2023 00:00:00 +0000

2021 年公司開始實施 322 WFH，少了通勤的時間，在家的時間也多了，就想在上班時也能好好對待自己，雖然是木耳但始終會想知道，網路上說的獨立訊源減少雜訊是有多重要，亦或只是玄學?於是誕生了Raspberry pi 4 + piCorePlayer 7.0.0 折騰筆記這篇筆記，到現在這個部落格的累積曝光最高的也是因為這篇吧。

雖然說現在已經出到 8.2.0，但也已經是 2022 年六月的版本了，起初因為 raspberry pi 4b 便宜而使用 piCorePlayer，後來也因 raspberry pi 4b 漲價(漲幅超過 100%)進而不使用 piCorePlayer，不知道官方後來沒更新了是因為樹莓派太穩定，還是真的太貴了…。

從 Bare Metal 到 Docker

當時在學習 HomeLab，首先是從 portainer 開始玩，也因此誕生了 logitech media server 搭配 docker 實現雙機分離。後來也用著同樣的 image 將 lms 建在 k8s cluster 內，遇到的比較髒的問題是 nginx 的 port 用非正式的方式解決。

這時候其實已經不在乎 logitech media server 是否帶來更好的音質了，也沒有連動 NAS 的音樂，主要是使用 Youtube Plugin 播放 Youtube 上的內容(即便有訂閱 Youtube Premium)。以及使用 Podcast Plugin 收聽 podcast。

使用 docker 的好處不外乎一個字，省，於是我把 raspberry pi 4b 也給賣了。

從 Docker 到 Podman 與 LXC

2022 年台灣疫情大爆發，公司也從 322 變成全遠端，但也在 2022 下半年恢復 322，於 2023 年正式恢復正常進辦公室。在這期間發現 logitech media server 使用 docker 做為執行環境，除了省物理機的錢(相較 bare metal)，更省顯示卡資源。

WSL2 中使用 systemd 管理 podman 的 container

raiven.kao@gmail.com (Raiven Kao) — Mon, 13 Feb 2023 00:00:00 +0000

原本使用 wsl-distrod 來作為 wsl 中 systemd 的實現方式，後來 microsoft 宣布 wsl 支持 systemd 後，distrod 等等 repo 就沒有在更新了呢，是巧合嗎?我不這麼認為。

這篇簡略紀錄 wsl2 中啟用 systemd 作為 process 管理工具以及配合紅帽推出的 podman 來取代(斷捨離)docker desktop。

環境

wsl2 + ubuntu 22.04

❯ neofetch
            .-/+oossssoo+/-.               raiven@raiven
        `:+ssssssssssssssssss+:`           -------------
      -+ssssssssssssssssssyyssss+-         OS: Ubuntu 22.04.1 LTS on Windows 10 x86_64
    .ossssssssssssssssssdMMMNysssso.       Kernel: 5.10.43.3-microsoft-standard-WSL2
   /ssssssssssshdmmNNmmyNMMMMhssssss/      Uptime: 3 hours, 10 mins
  +ssssssssshmydMMMMMMMNddddyssssssss+     Packages: 2005 (dpkg), 4 (snap)
 /sssssssshNMMMyhhyyyyhmNMMMNhssssssss/    Shell: zsh 5.8.1
.ssssssssdMMMNhsssssssssshNMMMdssssssss.   Theme: Adwaita [GTK3]
+sssshhhyNMMNyssssssssssssyNMMMysssssss+   Icons: Adwaita [GTK3]
ossyNMMMNyMMhsssssssssssssshmmmhssssssso   Terminal: Windows Terminal
ossyNMMMNyMMhsssssssssssssshmmmhssssssso   CPU: AMD Ryzen 9 5900X (24) @ 3.700GHz
+sssshhhyNMMNyssssssssssssyNMMMysssssss+   GPU: dbac:00:00.0 Microsoft Corporation Device 008e
.ssssssssdMMMNhsssssssssshNMMMdssssssss.   Memory: 1427MiB / 15966MiB
 /sssssssshNMMMyhhyyyyhdNMMMNhssssssss/
  +sssssssssdmydMMMMMMMMddddyssssssss+
   /ssssssssssshdmNNNNmyNMMMMhssssss/
    .ossssssssssssssssssdMMMNysssso.
      -+sssssssssssssssssyyyssss+-
        `:+ssssssssssssssssss+:`
            .-/+oossssoo+/-.

wsl2 中啟用 systemd

請確保 wsl2 的版本是 version 2，可以在 cmd/powershell 中查看

gin 搭配 html/template 包實現動態生成 HTML 文件

raiven.kao@gmail.com (Raiven Kao) — Thu, 26 Jan 2023 00:00:00 +0000

起因

在網站註冊流程中，若是用信箱驗證，網站會寄送一封驗證信到指定的電子信箱。信中可能含有 verify token 或是直接是寫好的 verify URL。至於實作方面我們可以透過 Go 1.16 推出的 Embedding Files 搭配 html/template，實現動態生成 HTML 信件，用以寄送至指定信箱。

本篇內容的詳細程式碼可以到 github 頁面查看。

實作

資料夾結構:

project/
├─ templates/
│  ├─ template.go
│  ├─ success.tmpl
│  ├─ verify.tmpl
├─ main.go

templates

project/templates/template.go

在包內宣告私有變數，透過 Embedding Files 讀出目錄內的所有檔案。
```
package template

//go:embed *
var f embed.FS
```

宣告需要被轉換成 HTML 模板的檔案名 TemplateName，可以用 go-enum 來自動生成變數。並將其註冊進陣列 _TemplateNameNames 內。

package template

// ENUM(
// success.tmpl
// verify.tmpl
// )
type TemplateName string

func (x TemplateName) String() string {
	return string(x)
}

var _TemplateNameNames = []string{
	string(TemplateNameVerifyTmpl),
	string(TemplateNameSuccessTmpl),
}

// TemplateNameNames returns a list of possible string values of TemplateName.
func TemplateNameNames() []string {
	tmp := make([]string, len(_TemplateNameNames))
	copy(tmp, _TemplateNameNames)
	return tmp
}

const (
	TemplateNameVerifyTmpl  TemplateName = "verify.tmpl"
	TemplateNameSuccessTmpl TemplateName = "success.tmpl"
)

最終將 embed files 與檔案名丟給 html/template 包請他們我們轉換成 template。

後端工程師用 Golang 在 WSL 中寫 GUI 是不是搞錯了甚麼 - 安裝篇

raiven.kao@gmail.com (Raiven Kao) — Thu, 26 Jan 2023 00:00:00 +0000

由於先前將 raspberry pi 4b 給賣掉了，bmx280 中基於 bme280 而產生的 exporter 因此失去戰鬥能力，藉此玩玩 tinygo，透過 serial port 透過 raspberry pi pico 對 bme280 讀取溫溼度。在開發過程中發現，WSL 中，command line 輸入:

GOOS=windows go run main.go

這樣會吃 windows 的環境，比如讀 serial port 需要 COM port，這樣就不是去讀 /dev/ttyS4 而是讀 COM4，這 cross compile 也太方便了吧…。

後續在工作上接收了需要寫一個 websocket server/client，而 client 需要:

有圖形化最好 (TUI or GUI)
跑在 windows 桌面上

，開發過程中再次感受到 cross compile 的方便，有點慶幸是在這個一個方便的時代學習敲鍵盤(?

Requirement

Golang 1.16+ ()
Docker or Podman

在 WSL 中建立 X Window System 環境

因為我的 Golang 環境是基於 WSL，於是我需要先準備在 WSL 中能跑的 GUI 環境。在 Unix like 使用的 GUI 被稱之為 X Window System 或 X11 或 X，以所需的情形來說即是需要在 Windows 中啟動 X server，來與 WSL 中的 X client 連線。

解決 VM 關機時等待容器關閉

raiven.kao@gmail.com (Raiven Kao) — Wed, 11 Jan 2023 00:00:00 +0000

[     *] A stop job is running for libcontainer container xxxxxxxx (10s / 1m30s)_

過去 kubernetes 還跟 docker-shim 手牽手時，在關閉 k8s node vm 時常常出現等待 docker-shim 關閉，直到一分三十秒被 time out 才正確關機。若是開發機就當作去尿尿的時間就好，但若是重要的環境停機備份，或是斷電時靠 UPS 提供電源等待系統關機，那浪費時間就不好了。

這次在 home lab 中採取省電措施，不用 1 master + 1 node 的組合，直接使用 k3s 作為家用 kubernetes 的實驗環境。但依然在關機時會需要等待 containerd-shim 等等被 time out kill 才會完成關機。

若是沒有做特別的設定，或是沒有過分的 stateful pod，找到了 k3s issue #2400 中的解決方法

Stopping K3s

To allow high availability during upgrades, the K3s containers continue running when the K3s service is stopped.

2023 展望

raiven.kao@gmail.com (Raiven Kao) — Sun, 01 Jan 2023 00:00:00 +0000

TL;DR

今年還沒躺平。

你不是喜歡寫程式的人，是用程式吃飯的。

年前 CEO 這麼對我說，後面接著一段話:

像我跟他(指主管)是喜歡寫程式的，沒人打擾的話我們可以在家一直玩這些。

跟主管借了《Clean Architecture》來看，每次在看軟體「工程」的書時，都備感挫折。《程式設計師的自我修養－連結、載入、程式庫》中提到的編譯器、連結器，我壓根就沒學過，這種滿滿的挫折感，在 Clean Architecture 中得到了解答。

台灣的資訊系在國外的最正統名稱是 Computer Science a.k.a. C.S.，而我的學士學位是資訊管理 Department of Information Management，我們接受的教育是怎麼去快速理解 domain，並在運用該領域的領域知識開發輔助用的資訊系統，課程著重在 ERP、CRM、KMS 等等資訊管理系統(MIS)。作業系統課程不會教你減少分支預測帶來的好處，資料庫管理課程不會教 Lock Level 把整張表鎖起來會被罵，資料結構課程不會教你怎麼用程式實作 linked list、tree，程式設計課程更不會去看你的時間/空間複雜度。

或許也只能怪自己在念書時得過且過，讓現在的自己需要花時間去補其他人早就知道的知識。

似乎也是因為這種挫折感給了自己莫大的動力，不想輸給「本科系」的學生，雖然已經 25 歲了，但及早發現及早治療吧?過去總是喜歡把不理解的部分都弄懂才往下一步走，也是慢慢地改變自己且戰且走、以戰養戰。

舉例來說，如果要把整個公司專案的程式碼、技術債的原因、神秘數字的由來、歷史共業等等，全部都摸熟才能開始寫 code，那可能就會失去許多成長的機會。

工作不像在學校，不會要求你每次都要一百分，應該是先做出 60 分，甚至 40 分，再慢慢迭代成 100 分。

CEO 如此說著，也符合軟體開發流程迭代機制，先拿 prototype 去撈錢再來修(?)。

除了有些設計原則是需要最初就先講好比較好(e.g. Cloud Native, API First)，似乎沒有甚麼是「非這麼做不可」，更多的是「不要這麼做比較好」。

言歸正傳，對 2023 年的展望呢，希望身體健康，也希望能拉近與同儕間的距離，多少不想輸給碩畢的同學XD。

在 AWS 上使用 EC2 建立 FRP 玩玩內網穿透

raiven.kao@gmail.com (Raiven Kao) — Sat, 19 Nov 2022 00:00:00 +0000

前言

TL;DR

2022 年上旬熱衷於軟路由，在 Raspberry Pi 4b 上裝了 openWRT 來玩，使用 USB 網卡作為 LAN NIC，雖然使用上完全沒有問題，但透過 USB 始終有個芥蒂，「就不能多個 pci-e 來接網卡嗎」，於是衝動順勢買了 Mikrotik RB5009UG+S+IN。

RB5009G 為 arm64(ARMv8)，系統為 RouterOS v7，透過 ZeroTier 插件可以實現內網穿透以及 VPN，一直以來可在外連回家裡做事，連 Jellyfin 使用起來都很順。

事出必有因，ZeroTier 的服務器在未知的地方，VPN 的設定也是在網頁上設定，即便不需要太過擔心，但若是 ZeroTier 被攻擊，那自己的內網也危險了。後來又遇到一次，在某處透過 Windows rdp 連回家開 VScode 做事，但敲鍵盤會有一到兩秒的延遲，加劇了需要替換掉 ZeroTier 的想法。

frp 是一個由 golang 寫出來的 reverse proxy…，其他的到 github 看比較清楚 XD。

這篇文章主要是透過 frp 建立內網穿透，雖然大部分都在建立 AWS EC2 instance，frp 的建立實在是非常簡單，VPN (maybe WireGuard?)的實現會另外再寫一篇。

事前準備

一個 AWS 帳號
一台 linux 主機作為 frp client

建立 Amazon EC2

建立執行個體

建立好帳號後，進入 AWS console，點擊 EC2。
點擊啟動執行個體
取名為 frp-tunnel
選用自己習慣的 linux distro，這邊我習慣使用 ubuntu，故選 ubuntu 22.04。
執行個體類型選 t2.micro，金鑰由於安全因素，請建立新的金鑰對(key pair)
由於我使用 ubuntu 22.04，故使用 ED25519 來加密(RSA 已被淘汰)。下載下來的 pem or ppk 需要好好保存，未來不能再下載。
網路設定的部分，ssh 的 source 使用我的IP，不要一開機就被陌生人打穿。
設定存儲的部分，若是使用 AWS Linux 的話可以預設 8GB 沒問題，我自己的 ubuntu vm 習慣 20GB，所以設成 20GB。
最後確認一下右邊的摘要，就可以點擊啟動執行個體。
建立完成後就會轉跳至完成頁面。

ssh 連線至 EC2

在 console 頁可以看到剛剛建立的 EC2 instance，點擊可以進入 instance 頁面。

zsh & oh-my-zsh & tmux install cheat sheet on ubuntu 22.04

raiven.kao@gmail.com (Raiven Kao) — Sun, 30 Oct 2022 00:00:00 +0000

oh my zsh & power lever 10k

install deps
```
sudo apt install git curl -y
```
install zsh
```
sudo apt install zsh -y
```

check is installed

cat /etc/shells | grep zsh

# raiven@k3s:~$ cat /etc/shells | grep zsh
# /bin/zsh
# /usr/bin/zsh

install oh-my-zsh

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

install powerlevel10k

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

install fonts:

wsl:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/omegaatt36/dotfiles/main/install_fonts.sh)" --windows

linux:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/omegaatt36/dotfiles/main/install_fonts.sh)"

change login shell(must logout and login again)

proxmox ve shrink vm disk size

raiven.kao@gmail.com (Raiven Kao) — Sun, 04 Sep 2022 00:00:00 +0000

由於 zpool 吃超過 80%，故將其中一個 VM(k8s-worker) 的硬碟縮小(200GB=>100GB)

pve: 7.2.7
zfs:
- zfs-2.1.5-pve1
- zfs-kmod-2.1.5-pve1

確認 vm disk 剩餘空間

$ df -h
Filesystem      Size  Used Avail Use% Mounted on
/dev/vda1        197G   14G   178G  7% /

vm 關機
下載 gparded iso 到 pve
vm 從 gparded iso 開機並縮減 disk 大小
pve server 針對 vm 的 hard disk 調整占用大小 switch(allocate storage type)
- case LV: lvreduce -L 5G /dev/pve/disk-name (縮小到只剩 5G) or lvreduce -L -5G /dev/pve/disk-name (縮小 5G)
- case qcow2: qemu-img resize --shrink <vmfile.qcow2> [+-] or size
- case ZFS: zfs set volsize=<new size>G rpool/vm-<vm id>-disk-<disk number> 舉例: vm(205) 的虛擬硬碟(vm-205-disk-0)放在 zpool land 上面，已經將 vm 縮小至 100GB
```
❯ zfs list
NAME USED AVAIL REFER MOUNTPOINT
land/vm-205-disk-0 236G 354G 119.3G -

    ❯ zfs set volsize=100G land/vm-205-disk-0

    ❯ zfs list
    NAME                     USED  AVAIL     REFER  MOUNTPOINT
    land/vm-205-disk-0       136G   354G     19.3G  -
    ```
```
在網頁 GUI 中修改強制刷新 disk。修改 disk 的設定，再調整回來

CentOS 7 kubernetes + containerd + calico basic installation tutorial

raiven.kao@gmail.com (Raiven Kao) — Sun, 20 Feb 2022 00:00:00 +0000

前言

鑒於最近接到 1 CentOS master + 2 Gentoo node k8s cluster 建置雜事，被自己不熟系統雷到，做個筆記紀錄一下，未來敲敲指令就可以了

                 ..                    root@master
               .PLTJ.                  -----------
              <><><><>                 OS: CentOS Linux 7 (Core) x86_64
     KKSSV' 4KKK LJ KKKL.'VSSKK        Host: KVM/QEMU (Standard PC (i440FX + PIIX, 1996) pc-i440fx-6.1)
     KKV' 4KKKKK LJ KKKKAL 'VKK        Kernel: 5.4.180-1.el7.elrepo.x86_64
     V' ' 'VKKKK LJ KKKKV' ' 'V        Uptime: 2 mins
     .4MA.' 'VKK LJ KKV' '.4Mb.        Packages: 359 (rpm)
   . KKKKKA.' 'V LJ V' '.4KKKKK .      Shell: bash 4.2.46
 .4D KKKKKKKA.'' LJ ''.4KKKKKKK FA.    Terminal: /dev/pts/0
<QDD ++++++++++++  ++++++++++++ GFD>   CPU: Common KVM processor (4) @ 3.493GHz
 'VD KKKKKKKK'.. LJ ..'KKKKKKKK FV     Memory: 97MiB / 16015MiB
   ' VKKKKK'. .4 LJ K. .'KKKKKV '
      'VK'. .4KK LJ KKA. .'KV'
     A. . .4KKKK LJ KKKKA. . .4
     KKA. 'KKKKK LJ KKKKK' .4KK
     KKSSA. VKKK LJ KKKV .4SSKK
              <><><><>
               'MKKM'
                 ''

此篇 CentOS 寄宿於 PVE 下，kernel 已升級為 5.4.180-1.el7.elrepo.x86_64 使用 containerd 作為 cri 使用 calico 作為 cni，並使用 host 唯一的網卡，不做其他進階設定。

CentOS 7 upgrade kernel

raiven.kao@gmail.com (Raiven Kao) — Sun, 20 Feb 2022 00:00:00 +0000

查看目前 kernel 版本

> uname -a
Linux R350-1 3.10.0-1160.53.1.el7.x86_64 #1 SMP Fri Jan 14 13:59:45 UTC 2022 x86_64 x86_64 x86_64 GNU/Linux

添加 ELRepo 公鑰

rpm --import https://www.elrepo.org/RPM-GPG-KEY-elrepo.org

安裝 ELRepo yum 來源

rpm -Uvh https://www.elrepo.org/elrepo-release-7.0-4.el7.elrepo.noarch.rpm

查看可用的 kernel

yum --disablerepo="*" --enablerepo="elrepo-kernel" list available

安裝最新的 kernel，挑一個安裝，這邊選擇 kernel-lt
- kernel-lt 為長期支援版
- kernel-mt 為 linus 個人維護版
```
yum --enablerepo=elrepo-kernel install kernel-lt
```

查看目前已安裝的 kernel

sudo awk -F\' '$1=="menuentry " {print i++ " : " $2}' /etc/grub2.cfg

0 : CentOS Linux (5.4.180-1.el7.elrepo.x86_64) 7 (Core)
1 : CentOS Linux (3.10.0-1160.53.1.el7.x86_64) 7 (Core)
2 : CentOS Linux (3.10.0-1160.el7.x86_64) 7 (Core)
3 : CentOS Linux (0-rescue-b804ce66fb404eb7a5dd04547e3e972e) 7 (Core)

如果結果為空，或是沒有這個文件，可以先進行 grub2-mkconfig -o /boot/grub2/grub.cfg

改善 Proxmox VE/Debian 始終跑在最高頻率

raiven.kao@gmail.com (Raiven Kao) — Sun, 09 Jan 2022 00:00:00 +0000

這幾天把便宜撿到的 Threadripper 2950X 平台也上 Proxmox VE 玩玩了，裝完系統後才發現自己太習慣於 windows 下的電源管理，一直都沒發現 linux 下 CPU 頻率都是拉滿的狀態，找了debian 下進行電源管理的電源計畫設定教學達到降溫省電，順便做做紀錄。

此篇文章的硬體基於

root@raiven:~# neofetch
       _,met$$$$$gg.          root@raiven
    ,g$$$$$$$$$$$$$$$P.       -----------
  ,g$$P"     """Y$$.".        OS: Debian GNU/Linux 10 (buster) x86_64
 ,$$P'              `$$$.     Host: HP Z2 SFF G4 Workstation
',$$P       ,ggs.     `$$b:   Kernel: 5.4.106-1-pve
`d$$'     ,$P"'   .    $$$    Uptime: 276 days, 9 hours, 51 mins
 $$P      d$'     ,    $$P    Packages: 719 (dpkg)
 $$:      $$.   -    ,d$$'    Shell: bash 5.0.3
 $$;      Y$b._   _,d$P'      Terminal: /dev/pts/1
 Y$$.    `.`"Y$$$$P"'         CPU: Intel Xeon E-2278G (16) @ 5.000GHz
 `$$b      "-.__              GPU: Intel Device 3e9a
  `Y$$                        Memory: 48763MiB / 64099MiB
   `Y$$.
     `$$b.
       `Y$$b.
          `"Y$b._
              `"""

root@raiven:~# ^C

用 watch -n 1 "cat /proc/cpuinfo | grep MHz" 可以查看當下的 cpu 頻率狀態。

logitech media server 搭配 docker 實現雙機分離

raiven.kao@gmail.com (Raiven Kao) — Sat, 04 Dec 2021 00:00:00 +0000

前言

雖然官方 releases 頁面似乎還沒發布，不過前一陣子把 piCorePlayer 升級到 8.1.0，看起來似乎還是 unstable，懶得倒版回去 8.0.0，趁這個機會把一直想玩的雙機留兜起來。

雙機顧名思義為 client 與 server 分開在兩台機器上，piCorePlayer 的 client 為 Squeezelite，server 則為 Logitech Media Server，事實上在 windows 上也有 client Squeezelite-X可以玩，預期中的最終成品將會是「三機流」吧 XD

LMS 解決方案

採用 lms community 的 docker image lmscommunity/logitechmediaserver 作為這次 server 端的 service。

安裝流程

此篇文章使用 portainer 作為 GUI 方便演示，若熟悉 docker 與 k8s 的可以自行下指令安裝。

首先我把我的音樂都存放在 NAS 上，先將 music 資料夾給共享出來
接著到 portainer 中建立三個 volume a. lms-music 輸入在 NAS 分享出來的目錄與使用者、密碼，建立一個 cifs mounted volume b. lms-config c. lms-playlist
接著到 stack 中，複製貼上官方的 docker-compose，若 portainer 已經佔用了 port 9000，則需要更改暴露的 port port:port/tcp 並追加環境變數 HTTP_PORT=port，我最終的 stack 設定為:

lms:
    image: lmscommunity/logitechmediaserver
    volumes:
      - lms-config:/config:rw
      - lms-music:/music:ro
      - lms-playlist:/playlist:rw
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro
    ports:
      - 9002:9002/tcp
      - 9090:9090/tcp
      - 3483:3483/tcp
      - 3483:3483/udp
    environment:
      - HTTP_PORT=9002
    restart: always

點下 Deploy the stack 後就完成了
可以到 container 下看是否已經啟動完成了，並稍微記一下 container 的 hash，在稍後 windows 的設定中會出現。

piCorePlayer 設定

進入到 piCorePlayer web 中的 Squeezelite Settings 設定頁面，並在 LMS IP 中輸入 portainer 的 ip 位置後點擊 Save，大功告成。

A=B 遊完心得、解法

raiven.kao@gmail.com (Raiven Kao) — Wed, 13 Oct 2021 00:00:00 +0000

Steam 上推出了一款 A=B，稍微玩了一下，下面提供自己的解法。

小試了一下，這個迷你語言每一行由左側、等號=、右側組成，左側會被取代成右側，並且每次取代完都會從第一行重新開始，有點像在寫遞迴。

第一章 A=B

1-1 a取代成b，限定一行。
```
a=b
```
1-2 變成大寫，限定三行。
```
a=A
b=B
c=C
```
1-3 去掉重複的，限定三行。
```
aa=a
bb=b
cc=c
```
1-4 去掉連續的a，限定兩行。
```
aaa=aa
aa=
```
1-5 只會給 a 與 b，回答最多的是 a 還是 b，最多四行。
```
ab=
ba=
aa=a
bb=b
```
1-6 排序，最多三行。
```
ca=ac
cb=bc
ba=ab
```

第二章新的關鍵字

多了一個新的關鍵字 return，僅能修飾右側語法，並且要用()包起來

2-1 回答 helloword，最多一行。
```
=(return)helloworld
```
2-2 是否至少包含三個 a，最多四行。
```
b=
c=
aaa=(return)true
=(return)false
```

2-3 字數除以 3 的餘數，最多六行。

c=a
b=a
aaa=
aa=(return)2
a=(return)1
=(return)0

2-4

ca=ac
ba=ab
cb=bc
aaa=a
bbb=b
ccc=c
aa=(return)false
bb=(return)false
cc=(return)false
=(return)true

2-5

aaa=aa
aa=d
bbb=bb
bb=d
ccc=cc
cc=d
ab=(return)false
ac=(return)false
ba=(return)false
bc=(return)false
ca=(return)false
cb=(return)false
d=
a=(return)true
b=(return)true
c=(return)true
=(return)false

2-6

ba=ab
ca=ac
cb=dc
bc=d
bd=db
ad=
a=(return)false
b=(return)false
c=(return)true
=(return)false

2-7

ba=ab
ca=ac
cb=bc
ab=d
ad=da
da=aa
ac=
bc=
d=b
cc=c
bb=b
aa=a

Kubernetes 學習筆記 - Ubuntu kubeamd 建置 cluster

raiven.kao@gmail.com (Raiven Kao) — Sun, 19 Sep 2021 00:00:00 +0000

環境

物理機: 2278G/16G DDR4 ECC*4/1T MX500 OS: - master: Ubuntu server 20.04 - node: Ubuntu server 20.04

安裝 docker、kubeadm、kubelet、kubectl

安裝 docker

sudo apt install apt-transport-https ca-certificates curl gnupg-agent software-properties-common -y

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io -y

sudo usermod -aG docker $USER

登出再登入

安裝 kubeadm kubelet kubectl

sudo apt-get install -y apt-transport-https curl
sudo su
curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key add -

sudo cat <<EOF >/etc/apt/sources.list.d/kubernetes.list
deb https://apt.kubernetes.io/ kubernetes-xenial main
EOF
exit

sudo apt-get update

# apt-cache madison kubeadm
# K_VER="1.20.5-00"
# apt install -y kubelet=${K_VER} kubectl=${K_VER} kubeadm=${K_VER}

# 不指定版本的話直接安裝即可
sudo apt install -y kubelet kubeadm kubectl
# 若需要鎖定版本可以使用 apt-mark hold
sudo apt-mark hold kubelet kubeadm kubectl

設定 kubeadm

master

sudo kubeadm init \
    --pod-network-cidr 網路區段 \
    --apiserver-advertise-address 本機IP \
    --apiserver-cert-extra-sans gcp IP

# kubeadm init --pod-network-cidr 172.100.0.0/16 --apiserver-advertise-address 10.140.0.2 --apiserver-cert-extra-sans 130.211.253.131

結束後會看到

Prometheus 學習筆記 - 基本架構與資料結構

raiven.kao@gmail.com (Raiven Kao) — Sat, 18 Sep 2021 00:00:00 +0000

Prometheus Overview

架構

Exporter: 要被採集的目標 job 中曝露 metrics 的組件，負責轉換資訊成 prometheus 可解讀的格式。由於某些早於 prometheus 的 service 因為某些原因，不想主動在服務中曝露 metrics，故可以用一些額外的 exporter 將這些 service 中的 metrics 轉成 prometheus 格式，並曝露埠。
- node exporter
- mysql exporter
Push Gateway: 由於有些任務時間太短，可能不到 prometheus pull 的週期，可讓這些 jobs 主動把 metrics push 到這個 push gateway，好讓 premetheus server 可以 pull。

Prometheus Server

Retrieval(retrieval system): 主要負責 pull 指定的 target

# /etc/prometheus/prometheus.yml
scrape_configs:
  - job_name: "prometheus"
    static_configs:
      - targets: ["localhost:9090"]
  - job_name: "node_exporter"
    static_configs:
      - targets: ["localhost:9100"]

TSDB: 時間序列資料庫，存放 pull 到的 metrics
HTTP Server: 為 PromeQL 查詢提供接口

Service Discovery:
- kubernetes: 自動發現 k8s 中 pod 增加減少以及 probe 異動等等
- file_sd: 通過 config 實現服務的自動發現
Alert Manager: 當 prometheus server 發現某某某 job 已經達到設定好的通知閾值進行通知的 service。
PromeQL: 無論是自帶 web UI 或是串接 Grafana，都是通過 http 進行 PromeQL 查詢後做視覺化處理 TSDB 中的時間序列資料。

資料結構

下面範例中會有更詳細說明

Raspberry pi 4 + piCorePlayer 7.0.0 折騰筆記

raiven.kao@gmail.com (Raiven Kao) — Sun, 02 May 2021 00:00:00 +0000

前言

鑒於想要剛好逛到 Raspberry pi 4 出了(2019)，剛好手邊又有兩顆閒置的喇叭，於是產生了做一套網路串流音樂撥放器。用到的硬體如下：

Raspberry pi 4b 4G ver 1.2 樹莓派的部分選用 4G 版本，由於 4G 跟 8G 版本差價有點大，僅作為多媒體撥放器，應該不需要那麼大量的記憶體，故降梯成本僅選用 4G 版本。至於 1.2 版本差在哪裡可以參考這篇文章，主要修正了 type-C 供電問題。
Argon ONE m.2 由於 pi 4b 的 cpu 較 3b+ 升級很多，同時發熱量也提升了，故得選用一個同時具有散熱、美觀、擴充的外殼，剛好手邊有汰換下來的 m.2 SATA SSD，於是選擇了 Argon ONE m.2。
直流電源供應器儘管線性電源如 Keces P3 或便宜一點 ifi iPower X 或是老虎魚都是很好的穩定 5V 直流電源供應器，但由於使用樹莓派就是不想花大錢，用比系統本身還高價如此多的周邊，似乎有點本末倒置，魚是只用了手機的 type-C 5V/3A 變壓器作為電源供應器。

硬體安裝

硬體安裝部分不在這次探討範圍，由於每個人使用的外殼均不相同，文章中就假設是裸機設定。

系統選擇

由於是第一次接觸 Raspberry pi as audio player，一開始是看到 Volumio 與 Moode 等等，也實際安裝了一次 Volumio，但由於慧根不夠(X)，或是不知道撞到了什麼，只要不小心設定錯音訊，便會導致系統無法撥音樂，也懶得 debug 了，於是想說乾脆來挑戰看看 piCorePlayer。

Golang 學習筆記 Day 0 - Why Golang & 安裝篇

raiven.kao@gmail.com (Raiven Kao) — Tue, 25 Aug 2020 00:00:00 +0000

免責聲明，此篇為個人學習筆記，非正式教學文，僅供參考感謝指教，有任何內容錯誤歡迎發 issue。

Why Golang

在高中時期，除了一年級上學期是用 C 打開程式大門之外，大家都知道的，畫金字塔、 cin 、 cout 等等基本的邏輯觀念，一年級下學期開始就是 C#、HTML、PHP，也玩轉在 CPLD、Arduino、焊三角錐、兩根同軸焊接，總之就是全部吃掉就對了，雖然都是皮毛但不至於完全沒印象。

然而到了大學，敝人不才沒有考上一般大學，也沒考上工科第一二志願科大，在整個大學過程碰了最多的反而是 python、machine learning。然而也都是碰皮毛~~因為都在玩社團、學攝影~~，事實上在大學時期程式功力已荒廢大半。

所幸在實習期間，公司願意提供環境讓我邊學習邊成長後做出貢獻，而使用的後端語言是 PHP，然而就一年以來的使用 PHP 有以下優缺點：

學習曲線極低，但坑很多
解釋型腳本語言部署極方便
非靜態、非強行別、萬用 array 導致容易出現很多偷懶的 code
窮人聖經 LAMP、LNMP
歷史悠久 framework 眾多、工作好找，甚至有許多 C 底層的高校框架可以使用。
可以很 OO 也可以不 OO，寫 code 彈性極大
在 php 7.0 改用 zend 引擎後效能改頭換面，「原來 PHP 也可以寫遊戲」。搭配一些 C 底層框架，甚至可以跟 nodeJS 一較高下，而期望中 8.0 效能將再更高。

但是，再快也只是 AE86，腳本語言終究與「高效」存在矛盾，同時，與其在 PHP 中配合 IDE 使用 type hinting 自我約束，何不直接寫強行別語言呢?? 然而在看過許多主流 web service 語言後，最後決定來學學 Golang，而關於 golang 的優勢，可以點擊下方圖片看更多詳細。

Golang 學習筆記 Day 1 - Getting started

raiven.kao@gmail.com (Raiven Kao) — Tue, 25 Aug 2020 00:00:00 +0000

免責聲明，此篇為個人學習筆記，非正式教學文，僅供參考感謝指教，有任何內容錯誤歡迎發 issue。

在前一天介紹了為何要使用 golang、安裝過程以及基本的 hello world，這天將重點放在最基本的 golang 程式碼特徵。

packages

正如昨天關於 hello world 的解析中提到的，每個程式都是由一到多個 packages 組成的，也就是 .go 中必須宣告該檔案是哪個 package，且同一個資料夾中僅接受 xxx 以及 xxx_test 兩種 package名稱，也就是該 package 的名稱以及測試檔的「測試包」。

至於 package 要怎麼命名呢，首先要提到檔案該如何命名，雖然 go format 是對於程式碼風格十分嚴格的，但是對於檔案名稱似乎就沒那麼嚴謹，但整個社群中普遍會用 snake_case 或是 dash-case 作為檔案 (甚至是 package) 的命名。

aaabbbccc.go
time-machine.go
battery_charger.go

但是需要注意的是 go build 會忽略所有以 _ 或是以 . 作為結尾的後綴， underline 可能會導致在建構時被忽略。

再來提到 package 到底要如何命名呢，官方文檔中明確的提到不要用 camelCase 以及 snake_case 。

The style of names typical of another language might not be idiomatic in a Go program. Here are two examples of names that might be good style in other languages but do not fit well in Go:

RESTful server based on golang

raiven.kao@gmail.com (Raiven Kao) — Thu, 19 Mar 2020 00:00:00 +0000

很高興有個機會製作面試前的測試作業，也就趁這個機會做個筆記以及學習紀錄。

前置作業

先點列一下項目需求：

基本需求

based on golnag
The API interface you provide can be any of the following：RESTful、json rpc、gRPC
At least two sources
When a source is unavailable, the result of its last successful ask is returned
Use git to manage source code
Write readme.md and describe what features, features, and TODO which have been implemented

額外可選

Traffic limits, including the number of times your server queries the source, and the number of times the user queries you
Good testing, annotations, and git commit
An additional websocket interface is provided to automatically send the latest information whenever the market changes
Users can choose to use an automatic source determination, the latest data source, or manually specify the source of the data
Package it as a Dockerfile, docker-compose file, or kubernetes yaml
There is a simple front-end or cli program that displays the results
The API you provide has a corresponding file, such as a swagger, or simply a markdown file
Other features not listed but that you thought would be cool to implement

這邊就必須要先打預防針了，這篇僅為學習筆記，並非正式教學。且，我只是 Golang 初學者，所以這篇內也不會出現什麼高等級的解法，甚至也是第一次實作介接 API 呢 (笑)。而 DB 以及 redis 都是直接以方便使用去寫 dbi 而已並無用抽象曾去封裝，也進而導致 unit test 十分困難先擱置了，有空才會再針對性重構，而此次就先將目標專注在 API 介接。

Codewars Find X II in golang

raiven.kao@gmail.com (Raiven Kao) — Tue, 03 Mar 2020 00:00:00 +0000

想不到一眨眼半個月過去了，自從面試趨勢之後整個人彷彿被電到失去信心，在離職與等待面試消息期間，也只好振作補足不足的地方繼續向前。

而 docker 學習心得何時會產出呢？在學習過程中發現除了一般操作(day1 內容)外，底層或多 container 溝通都是大量的網路觀念與知識，需要更多知識量才能整理成筆記，不急不急。

由於學習過程發現而這段時間在 coding 能力上主要還是靠 codewars 上的題目，畢竟解完後能看別人的 code 來檢視自己的 code 能不能更好。其中不免遇到一些覺得很有趣的題目，好比這題 Find X II，他並不是什麼過分難的題目，邏輯也不是很難通，畢竟只是一個 6 kyu 的題目，但為何快一年了只有 44 個人解完呢，這就牽扯到下面要說的。

題目概要

有下一段程式碼:

func FindX(n int) int {
  if n == 0 {
    return 0
  }
  x := 0
  for i:=1; i<=n; i++ {
    x += FindX(i-1) + 3*i
  }
  return x
}

但 x 範圍為 1 <= n <= 10**6(1e6) ，請試著重構。且當 n 愈來試大時，可能會超過 int64 表達，故需要將結果對 10**9 + 7 取模

標記 FUNDAMENTALS OPTIMIZATION

解題邏輯

若沒有取模限制的話這題可以化簡為 O(1)，但很明顯不行。於是先將原題目化簡為 O(n):

func FindX(n int) int {
    mod := int(math.Pow10(9)) + 7
	m := 0
	for i := 0; i <= n; i++ {
		m = (m*2 + 3*i) % mod
	}
	return m
}

好測試過，就算是輸入 1e6 進去也很快就算出來了，於是提交答案

威康生命遊戲 in PHP

raiven.kao@gmail.com (Raiven Kao) — Thu, 23 Jan 2020 00:00:00 +0000

威康生命遊戲 in PHP

生命遊戲，無論在程式、哲學、生命探討上都十分有趣，在生命遊戲中甚至出現永動機。而在 Codewars 中也有生命遊戲的題目，規則也十分簡單，以下為維基百科的內容：

1. 每個細胞有兩種狀態 - 存活或死亡，每個細胞與以自身為中心的周圍八格細胞產生互動（如圖，黑色為存活，白色為死亡）
2. 當前細胞為存活狀態時，當周圍的存活細胞低於2個時（不包含2個），該細胞變成死亡狀態。（模擬生命數量稀少）
3. 當前細胞為存活狀態時，當周圍有2個或3個存活細胞時，該細胞保持原樣。
4. 當前細胞為存活狀態時，當周圍有超過3個存活細胞時，該細胞變成死亡狀態。（模擬生命數量過多）
5. 當前細胞為死亡狀態時，當周圍有3個存活細胞時，該細胞變成存活狀態。（模擬繁殖）

若想知道關於更多可以觀看上方由混亂博物館出品的影片，此篇就針對這 4kyu 的題目進行探討解法。首先題目中指出這個宇宙的 x,y 軸都是無限大的，所以生成高斯帕機槍且迭代過多次可能造成記憶體使用過量。

迭代

首先題目給定一個二維矩陣以及迭代次數(世代)，而需取得過了該迭代次數後的情形。

function get_generation(array $cells, int $generations): array
{
    if($cells == [])
    return [[]];
    $w = count($cells);
    $h = count($cells[0])
    for ($index = 0; $index < $generations; $index++) {
        $cells = getNextGen($cells, $w, $h);
        $sum = 0;
        foreach ($cells as $row) {
            $sum += array_sum($row);
        }
        if ($sum == 0) {
            return [[]];
        }
    }

    return $cells;
}

於是可以建立一個方法 getNextGen 來獲取下個世代的結果

VScode SFTP 快速同步文件到 Server

raiven.kao@gmail.com (Raiven Kao) — Mon, 20 Jan 2020 00:00:00 +0000

當 Server 環境使用白名單搭配 Reverce-Proxy 時，或是 dev、test 環境不供外部使用時，或許會將部分 code 存在只能靠內網連線的主機上，並透過 OpenSSH 供內部遠端操作。

而 PHP 快速部屬的便捷在於替換單一檔案不須重啟 Server (前提是並非把檔案載進 Memory 或轉化守護進程)，此時可以依靠 FTP 上傳單一檔案即好。但每次改個 code 還要想辦法上傳程式碼實在是太浪費時間了，如標題所述，如何快速同步 code 到 Server 上呢。

vscode-sftp 是一個在 VScode 中非常方便的擴充套件，上傳/下載/同步、單一/多伺服器、ftp/sftp，僅需設置一份或多份的設定檔便能(偷懶不切視窗)上傳檔案到 Server。然而正是環境 (production) 還是走正常 CI/CD 比較好。

安裝

首先在 VScode 中的市集，或是快捷鍵 ctrl+shift+P (或 F1) 打開指令窗口後輸入 extension:install。並搜尋 SFTP，認名作者 liximomo 點一下玩一年，上傳不花一分錢(支持者可以拉到下面點選 donate)。

設定上傳環境/參數

接著同樣打開指令窗口並輸入 SFTP: Config

注意由於是 JSON 格式，不能註解

主要配置好host, port, username, privateKeyPath, remotePath, ignore这参数即可：

name : 檔案暱稱
host : server IP/URL
port : 若 server 建置好 ssh 環境，可將 port 端口改為 22
username : 在 server 中的使用者名稱
remotePath : 欲上傳的目錄位置
privateKeyPath : 私鑰
password : 若有設私鑰則可有(null)可無
uploadOnSave : 自動上傳，個人是沒有開啟(經常性按 ctrl + S)
ignore :

{
    "name": "my_work_space",
    "host": "192.168.X.X",
    "port": 22,
    "protocol": "sftp",
    "username": "centos",
    "remotePath": "\\home\\centos\\***\\",
    "privateKeyPath": "C:\\***.pem",
    "uploadOnSave": false,
    "syncMode": "update",
    "ignore": [
        "**/.vscode/**",
        "**/.git/**",
        "**/.svn/**",
        "**/.DS_Store"
        ]
}

同步所有檔案

儲存後按下同樣打開指令窗口並輸入「SFTP: Sync Local -> Remote」，再選取剛剛設定中的 name(ex.my_work_space) 便可以重部整份資料夾/工作區到遠端伺服器上囉。

Evaluate mathematical expression in PHP

raiven.kao@gmail.com (Raiven Kao) — Thu, 16 Jan 2020 00:00:00 +0000

四則運算，不多，不就是加減乘除而已嗎，怎麼會在 Codewars 中被標記為 2 kyu 的題目呢?

總覺得這篇標題應該改為「Codewars 從入坑道棄坑，只需要一題就搞定」。首先我是在 2019 年底才接觸 Codewars，這種打怪練功的感覺讓我一下就上癮了，每天都在想今天能不能再拚一階，或是這題用另外一個語言會不會比較省時間。直到遇到了這題，足足卡了一整天。下面就來介紹一下四則運算在 PHP 中的解法吧。

先乘除後加減，看到括號先做

先舉一個簡單的例子 a+b 該怎麼做呢，有學過一點資料結構的應該很快就會回想起「中序轉後序」。

首先會需要將引入的字串轉為中序

// 123 + 456 * -789
// =>
// ['123', '+', '456, '*', '-', '789']

function isOp(string $s): bool
{
    return strpos("+-*/", $s) !== false ? true : false;
}

function changeStringToInfix(string $expression): array
{
    $infix = [];
    $count = strlen($expression);
    for ($i = 0; $i < $count; $i++) {
        if (isOp($expression[$i]) === false) {
            $j = $i;
            while ($i < $count && (isOp($expression[$i]) === false)) {
                $i = $i + 1;
            }
            $infix[] = substr($expression, $j, $i - $j);
            $i = $i - 1;
        } else {
            $infix[] = substr($expression, $i, 1);
        }
    }
    return $infix;
}

這時候可能有眼尖的會發現，不對阿中序怎麼可以兩個運算子(’*’, ‘-’)連在一起，恭喜你踩進四則運算第一個坑：負號可能是負號也可能是減號。於是可以使用一個偷吃步的方式，將運算子後的負號一率改成另一個代表負號的特殊符號，比如「@」。而這步可以使用正規表達式輕鬆辦到。

PHP ENUM 偽實現

raiven.kao@gmail.com (Raiven Kao) — Wed, 15 Jan 2020 00:00:00 +0000

Enumerations 又可簡稱為 Enum ，在眾多語言中都可以讓程式碼更高效簡潔，例如我們可以在 python 中這麼宣告，並且用 requests 模組打一個 request，即可透過 Enum 來模組化 Response

import enum
import request
class HTTPResponsecode(enum.Enum)
    OK = 200
    BAD_REQUEST = 400
    NOT_FOUND = 404

r = requests.get('https://omegaatt.com/')
print(r.status_code == HTTPResponsecode.OK)
# True

但是在 PHP 中原生是沒有內建 Enum 的，必須安裝 perl 的 SplEnum 類套件庫，方能直接使用 Enum 的功能。或是可以透過以下的方式達到接近的效果。

極簡易版 Enum

首先，建立一個 Enum 類，一樣舉例為 HTTP 的 response code

abstract class HTTPResponsecodeEnum
{
    const OK = 200;
    const BAD_REQUEST = 400;
    const NOT_FOUND = 404;
}

這樣就完成最基本的 Enum 拉，只要透過簡單的 if 判斷便能輕鬆享受打包的方便

if($status_code == HTTPResponsecodeEnum::OK){
    // foo();
}

具有驗證功能的 Enum

根據防禦性程式寫法，我們知道千萬不要相信使用者傳過來的東西，必須去驗證資料是否正確時，極簡版本已經無法勝任。這時候可以使用 ReflectionClass 這個這個類別協助，由這個類來取得 Class 中的常數。

A piece of me

raiven.kao@gmail.com (Raiven Kao) — Mon, 01 Jan 0001 00:00:00 +0000

我是個熱衷於技術分享和學習的軟體工程師，專注於各種開源技術和工具的應用與實踐。在這裡，你將找到關於 Golang、Kubernetes、FRP、Prometheus 等多種技術的深入探討和實踐經驗。

我的專長

Golang: 我對 Golang 有深入的研究和豐富的實踐經驗，從 HTTP 路由到記憶體管理，無所不包。
Kubernetes: 熟悉 Kubernetes 的安裝和配置，包括使用 K3s 和 Cert Manager 進行集群管理。
DevOps 工具: 擅長使用各種 DevOps 工具，如 WireGuard、FRP、Prometheus，來優化和監控系統。
自動化和腳本: 使用 Golang 和其他腳本語言自動化各種任務，提高工作效率。
系統配置: 對 Linux 系統有深入了解，包括在 WSL2 上配置 Systemd 和 Podman。

部落格內容

在這個部落格中，我會分享我的工作筆記和學習心得，涵蓋以下主題：

軟體開發: 包括 Golang 的最佳實踐、HTTP 路由和鎖定機制等。
系統和網絡: 例如使用 WireGuard 建立安全的 VPN 連接，通過 FRP 設置內網穿透。
測試與自動化: 分享如何在敏捷開發中進行高效測試，以及使用 WakaTime 進行編碼時間跟蹤的經驗。
容器化和編排: 探討 Kubernetes 和 Docker 容器化技術，從安裝配置到實際應用。

聯絡我

如果你對我的內容有任何問題或建議，歡迎隨時聯絡我：

Email: raiven.kao@gmail.com
GitHub: github.omegaatt.com
LinkedIn: cv.omegaatt.com

謝謝你的訪問，希望你能在這裡找到有用的資訊並一起成長進步！

Resume

raiven.kao@gmail.com (Raiven Kao) — Mon, 01 Jan 0001 00:00:00 +0000

can't display PDF？Download

omegaatt

Unrounded Scaling：Go 1.27 浮點數轉換演算法的深度拆解

前言

Spec-First API：用 codegen 約束 LLM 與人類的 drift

前言

問題不是「有三份檔案」

Golang 1.27 新特性整理：泛型補完與轉正的實驗性功能

語言層面：泛型設計的最後一塊拼圖

Generic Method 真的來了

Go 1.27 即將支援 Generic Method：告別 package-level 函式的 workaround

前言

為什麼現在沒有 Generic Method？

把 k3s 從 Ubuntu 搬到 OpenSUSE MicroOS，順便換上 FluxCD GitOps

前言

為什麼選 OpenSUSE MicroOS

Pragmatic Clean Architecture in Go

前言

捨棄什麼

獨立的 Port/Adapter 層

DDD 的 Aggregate

保留什麼

package domain

k3s Ingress Controller 從 Nginx 遷移到 Traefik 同時整合 CrowdSec

前言

為什麼不選 Cilium Gateway API

用 Hetzner + Proxmox Backup Server 實踐 3-2-1 備份原則的異地備援

前言

為什麼選 Hetzner

GCP / AWS 的問題

放棄 Electron 與 Tauri? 我用 Wails + HTMX 打造 3MB 的跨平台桌面應用

前言

為什麼是 Wails + HTMX？

旅遊札記 - 2026 新年的關西遊

Day 1（1/2）：初雪與初売り

Clean Craftsmanship：在 LLM 時代重拾軟體工匠精神

為什麼在這個時間點讀這本書

紀律

童子軍規則

Test Doubles 的正名

Golang 1.25 testing/synctest 初體驗：告別在測試中寫 time.Sleep 的日子

前言

遇到的問題：不穩定的測試與魔法數字

RouterOS v7.21 container + App 組合拳，你的下一台 Router 也可以是 All In One Homelab

前言

RouterOS v7.21 的新變革：App

Container Image Optimization 那些年我們寫錯的 Dockerfile

致命的 chown

Golang 1.26 新特性在數量上史無前例的多

語言層面的改動

new(expr)：終於不用再寫輔助函數了

從 GrapheneOS 回歸原廠：Google Pixel 5 刷機紀錄

為什麼選擇 Android Flash Tool？

事前準備

2025 Recap

工作

健康

旅遊

Helm Smart Resource：讓你的 Chart 學會與既有資源和平共處

前言

核心難題：Ownership

實作細節

1. 定義所有權檢查

Interface 不是有開就好：從一個 PR 來看抽象化的重要性

前言

一個 PR 的故事

監控你的執行檔：初探 watchexec

用 Golang Bubbletea 打造終端機應用：從 Hello World 到多頁面架構

初探 Tauri：為了解決朋友的繁瑣任務，寫了個桌面 App

Prompt to Product：AI 時代開發者的範式轉移

那些年我們追逐的開發效率

從懷疑到接受的心路歷程

最初的抗拒與恐懼

重新定義效率的數學陷阱

從工具使用者到架構思考者

機器可讀設計的哲學革命

重新審視我們的設計習慣

如何利用 Golang AST 助攻 LLM 省 token 又高效

前言

LLM 直接消化大型 Code Base 的「痛」

Golang AST 如何「助攻」

`package domain`

致命的 `chown`

`new(expr)`：終於不用再寫輔助函數了