Linux on omegaatt

把 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（不可變作業系統），核心特性有幾個：

用 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 拉回來就可能要多付幾十美元。

告別 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。

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。

使用內建的 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

透過 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 一文中提到的：

透過 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 來獲取所有音訊設定檔

透過 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 簡單換掉一些參數:

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 時可能會發生

如何優雅地批次安裝 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 上的檔案來安裝

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 中查看

解決 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.

在 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 頻率狀態。

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) 便可以重部整份資料夾/工作區到遠端伺服器上囉。