布丁布丁吃什麼？

雜談：深刻體會Skype退役了 / Talk: Deeply Felt Skype's Retirement

2025-11-03T12:00:00.006+08:00

微軟在2025年5月5日關閉Skype。我本來以為對我影響不大，聽說現在已經不用Skype打0800免費電話。不過似乎不是每個銀行都是如此。

Microsoft is shutting down Skype on May 5, 2025. I initially thought it wouldn't affect me much, hearing that Skype is no longer needed for calling 0800 toll-free numbers. However, it seems that's not the case for every bank.

0800免費電話只能用市話的時代 / The Era When 0800 Toll-Free Numbers Could Only Be Used With Landlines

(圖片來源：https://pixabay.com/photos/telephone-technical-support-cisco-1223310/ )

也許現代人都習慣了用手機代替市話的通訊生活。但在以前，市話可是家家戶戶必備的重要通訊手段，而且通常一戶就是一支固定號碼，不太會修改。

相較之下，當時的手機號碼彷彿是拋棄式用品，大家可是說換就換。換了新的工作了，辦一個新的門號；男女交往分手了，換一個新的門號。當時沒有APP綁定手機門號做驗證這種機制，你記下朋友的手機門號多年後失聯，這一切都如此正常。

在這樣的情境脈絡下，公司客戶服務的免付費電話0800，幾乎都只開放給市話撥打，手機撥號會被拒絕接聽。我想這可能是因為這對客戶來說的免付費電話實際上是由公司方付費的緣故，他們只顧慮到當時是主流的市話，並沒有把行動電話納入考量。

行動電話不能撥打0800免付費電話，公司方大多會建議客戶改打市話客服，也就是讓使用行動電話的客戶自己繳交通話費，而且還是行動電話打市話的昂貴費用。當時在電話裡聽著「現在客服全在忙線中，請稍後片刻。」的自動語音，一邊看著手機上的通話時間，真的是讓人感到非常焦慮。

用Skype撥打0800 / Use Skype To Call 0800

(圖片來源：https://applealmond.com/posts/251833 )

當時拯救廣大手機使用者的救星，就是Skype。在當時，Skype是可以讓手機撥打0800的主要通訊手段。許多提供0800的銀行，包括中國信託、台新銀行、國泰世華等等，都可以用Skype撥打。

儘管在2024年的時候，Skype更換了電信營運商，造成撥打0800的時候會出現「發話人按國際電話費率付費」通知，但在沒有餘額的情況下使用Skype，0800還是可以繼續打的通。0800真的是佛心來著。

打0800不用Skype了 / No More Skype for 0800 Calls.

(表格來源：https://roo.cash/blog/creditcard-bank-service-phone-number/ )

在Skype停止營運的現在，其實很多銀行已經推出了能讓手機撥打的0800號碼。根據袋鼠金融的整理，國泰世華、台新銀行、臺北富邦銀行、永豐銀行、兆豐銀行、星展銀行、上海商銀、聯邦銀行、華南銀行、土地銀行、第一銀行、瑞興銀行，都能讓手機撥打0800。

也就是說，即使沒有Skype用來撥打市話0800的手段，我們也可以用自己的手機來打0800了。

結語：也許不應該打電話到客服 / In Closing: Maybe You Shouldn't Have Called Customer Service.

沒有Skype可以打市話0800，但我們也許還能用手機撥打0800。雖然是這樣說，但也並不是所有單位都有能讓手機撥打0800的管道。最近我在跟銀行聯繫的時候就遇到了這個狀況，索性牙一咬，用手機撥打市話吧。結果客服等了一千秒沒打通，通話費倒是扣款了100元，非常令人心疼啊。

後來我改用線上文字客服去詢問。文字客服每次都只會跟我說，他們會聯絡專人再回電給我，後來就要看運氣能不能接到客服打來的電話，但這樣總比花大錢還打不通客服還好吧？

沒有市話，在這種情況下還真的是很麻煩呢，唉。

感謝抖內！布丁光明燈上線 / Thanks for the Donation! Pudding Luminous Blessing is Online Now

2025-10-27T12:00:00.008+08:00

「布丁布丁吃什麼？」的捐款功能開設以來，陸陸續續也收到大善人們的愛心捐助。為了感謝大家的支持，我在部落格首頁加入了「布丁光明燈」來表達感謝。

Since my blog's the donation feature was launched, I have continuously received generous donations from kind benefactors. To express my gratitude for everyone's support, I have added a "Luminous Blessing (Donors)" to the blog's homepage to show my appreciation.

布丁光明燈 / Luminous Blessing (Donors)

會做布丁光明燈的原因，除了想要感謝大家的捐款之外，也希望給各位研究者、IT人員一些祝福。我個人比較不喜歡擺乖乖，但我相信這世界上的事情能夠順利運作，背後得要仰賴無數多的人與設備共同的付出。

如果我的部落格也能在大家背後，成為支持大家前進的其中一個動力來源，那就太好了呢。

如何捐款？ / How to Donate?

https://p.ecpay.com.tw/2462283

「布丁布丁吃什麼？」的捐款功能是用綠界支付實作。點下連結後將會跳轉到綠界的網頁。

你可以在「金額」的部分填入你想要捐款的數字，金額隨喜。但由於綠界的規定，每種支付方式都有最低可填入的金額。例如信用卡支付最低得要填寫6元。

填寫之後綠界會要求填寫付款人資訊。姓名跟手機雖然是必填的資料，但您可以輸入像是「楊先生」之類的稱呼，手機資訊僅是綠界金流使用，您的手機資訊不會透露給我看到。

收件人資訊也是一樣的方式。捐款完成後，綠界會發送通知到您的手機簡訊。如果您有填寫電子信箱的話，信箱也會收到捐款通知。

備註的部分，您可以填入留言給我的訊息。預設的情況下，我會把您的大名以姓氏加稱呼的方式，放到布丁光明燈上。例如「感謝楊先生支持點燈」。如果您希望以其他具名方式，或是不願意放上去的話，也可以在備註跟我說。

最後勾選後面的「我已閱讀並了解【個人資料運用聲明】並已確認上述資訊無誤。」，並按下「前往付款」即可。系統會跳出請您確認資料填寫無誤的訊息，確認後即可進入下一步。

接著就是付款的頁面了。依據付款金額，您可選擇信用卡、網路ATM、ATM虛擬帳號、超商條碼、超商代碼、綠界Pay的方式支付。支付完就算是完成捐款囉。

再次感謝各方大德的支持~ 願大德研究順利、伺服器跟程式都能穩定運作！

用Cloudflare Tunnel的內網穿透來連接Home Assistant的Google助理 / Using Cloudflare Tunnel for Internal Network Penetration to Connect Home Assistant to Google Assistant

2025-10-20T12:00:00.008+08:00

如果要讓Google助理操作Home Assistant所連結的設備，那麼必須要有能夠連上Home Assistant的公開HTTPS網址才行。由於原本我用的Telebit發生問題，所以我花了一些時間找尋替代方案。這篇就做個記錄吧。

To allow Google Assistant to control devices connected to Home Assistant, a public HTTPS address that can connect to Home Assistant is required. Since my original Telebit had issues, I spent some time looking for alternatives. This is just a record of that.

網路架構 / Network Architecture

在開始講解之前，我們要先釐清一下本篇文章所要著重的重點。

上圖的左半邊是Google助理連結Home Assistant操作智慧裝置的主要途徑。具體來說，我們在Android手機呼叫Google助理時，它背後會去操作Google Home應用程式裡面連結的裝置。Google Home的連結是透過我們在Google Cloud Platform (簡稱GCP)設定好Home Assistant的整合方式來連到我們區域網路裡面的Home Assistant，以此操作跟Home Assistant相連的智慧裝置，例如智慧燈泡。

如果設定完成的話，我們就能夠用語音指令來控制家裡的智慧燈泡。舉例來說，我們可以直接用語音控制來發送指令：「OK Google，關閉客廳燈光。」然後我們就能聽到Google助理回覆類似「好的，客廳燈光已關閉」的訊息，此時Home Assistant連接的智慧燈泡就會關閉。

然而上述的操作是在已經設定完成的前提下才能進行。而這背後的設定才是真正複雜的地方，也是本篇文章所要講述的重點。

我所在的網路環境並沒有公開IP，甚至連DDNS都沒辦法設定。如果要在外面連線到本地網路，就必須仰賴內網穿透、虛擬區網等技術。而這次為了要讓外面的GCP連接到本地網路的Home Assistant，Cloudflare Tunnel方案就成了我這次的選擇。

圖片來源：https://try.cloudflare.com/

Cloudflare為人知名的是它的試用方案：https://try.cloudflare.com/ 。不過試用方案trycloudflare.com 每次產生的網址都是隨機變化，這樣不能作為GCP的整合設定。所以我們這次用的是能夠固定網址的Cloudflare Tunnel方案。

選擇Cloudflare Tunnel方案的話，就會連帶增加託管Domain Name、設定HA trusted_proxies等幾個步驟。我稍微整理一下，把這些必要步驟列成上圖右邊的6點：

申請Domain Name
託管Cloudflare
設定Cloudflare Tunnel
安裝Cloudflare Tunnel
設定HA trusted_proxies
設定GCP

以下我會概述這些步驟的設定。由於這些步驟所使用的服務實在是太常改變，過幾年來看，本篇可能就已經不能使用了。所以大家參考看看就好。

1. 域名申請 / Domain Name Registration

為了要使用固定網址的Cloudflare Tunnel，我們要給它一個可供管理的網域名稱(domain name)。我本來想要用之前在DigitalPlat FreeDomain申請的免費網域名稱，但現在似乎是無法使用的樣子。網路上是有些可以申請網域名稱的網站，例如freedomain.one，但它提供的網域名稱並非跟根網域(root domain)，無法託管到Cloudflare上。

找到最後，我選擇的是L53 Domain Name。只要使用它提供的兌換碼「newuser」，每個帳號所申請的網域名稱第一年就能免費。然而必須注意的是，你所使用的email最好先在Gravatar註冊並上傳大頭照，不然很容易被當成可疑帳號而被取消申請。

確認我們可以修改網域的名稱伺服器，即可進行下一步。

2. 託管網域名稱到Cloudflare / Connect the Domain Name to Cloudflare

接著我們來到Cloudflare，進入 https://dash.cloudflare.com/。如果你還沒有註冊Cloudflare的話，可以到 https://dash.cloudflare.com/sign-up 註冊。註冊可以用Google帳號即可。

讓我們在Cloudflare Dashboard右上角的「+ Add」裡面進入「Connect a domain」。

1. 填入剛剛申請的網域名稱，然後 2. Continue 即可。

選擇Free免費方案。

在「Review your DNS records」裡面，跳到最下面，按「Continue to activation」。

跳出警告訊息，按「Confirm」繼續。

在「Last step: Update your nameservers to activate Cloudflare」裡面，我們可以看到Cloudflare提供的兩個名稱伺服器 (name server)。

回到L53 Domain Name，把名稱伺服器替換成Cloudflare提供的設定。

再到Cloudflare，按「Continue」繼續。

接下來你需要等待一段時間。我自己的經驗是2小時左右。雖然Cloudflare提供了「Check nameservers now」的按鈕可以按，但這也不會讓它立即生效。

如果生效的話，你的信箱會收到通知。這樣我們就可以繼續進行下一步了。

3&4. 設定並安裝Cloudflare Tunnel / Create and Install Cloudflare Tunnel

回到Cloudflare Dashboard https://dash.cloudflare.com/。我們可以看到剛剛設定的網域名稱已經啟用。

進入左邊導覽列的PROTECT & CONNECT > Zero Trust。

再Zero Trust區域，進入左邊導覽列的Networks > Tunnels。

按下「Create a tunnel」按鈕。

選「Cloudflared」。

設定Tunnel的名稱，然後Save tunnel。

接下來會看到各種作業系統下Cloudflared的安裝方法，請根據你的Home Assistant安裝方式來選擇。由於我是在Kubuntu 上以Docker運作Home Assistant，所以Cloudflared應該會架設在相容於Ubuntu的Debian上。

上圖的腳本中，1. 是安裝cloudflared所需要的指令，2. 是安裝目前設定的Cloudflare Tunnel的指令。依序在Home Assistant所在的作業系統裡面執行即可。

附帶一提，如果你要在Home Assistant的作業系統上移除原本安裝好的Cloudflare Tunnel，可以使用以下指令：

cloudflared service uninstall

圖片來源：https://youtu.be/OJBHG9oJTDk?t=180

如果順利安裝好的話，安裝腳本下面的「Connectors」會看到連接訊息。接著按「Next」繼續即可。

接著在「Published application routes」裡面進行設定：

Subdomain：自己命名即可，例如「ha」。
Domain：選擇剛剛託管的網域名稱。
Type：HTTP。選擇Home Assistant的預設連線HTTP。
URL：localhost:8123。這是Home Assistant的預設連線網址跟連接埠。

再來按右下角的「Save」，Cloudflare Tunnel就設定完成了。

未來我們就可以用「[Subdomain].[Domain]」的組合來開啟Home Assistant。

5. 設定HA trusted_proxies / Set "trusted_proxies" in Home Assistant's Configuration

然而，如果直接開啟Cloudflare Tunnel設定好的網址，我們卻會看到「400: Bad Request」的錯誤訊息畫面。別擔心，這不是Cloudflare Tunnel的問題，是Home Assistant的安全機制。

讓我們看看Home Assistant主控臺的訊息，它可能會出現以下內容：

ha  | 2025-10-18 20:45:46.002 ERROR (MainThread) [homeassistant.components.http.forwarded] A request from a reverse proxy was received from ::1, but your HTTP integration is not set-up for reverse proxies

這表示Home Assistant拒絕了來自「::1」的反向代理請求。

要解決這個問題，我們需要在Home Assistant的configuration.yaml裡面，加入以下內容：

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 127.0.0.1
    - ::1

然後重新啟動Home Assistant，讓設定檔生效。最後我們就能透過Cloudflare Tunnel來開啟Home Assistant了。

6. 設定GCP跟Android的Google Home

最後要設定GCP的部分，請參考Home Assistant的Google Assistant中的「Google Cloud Platform configuration 」：

https://www.home-assistant.io/integrations/google_assistant/#google-cloud-platform-configuration

步驟非常多，而且常常會隨著GCP改版而有些許不同。遵循Home Assistant的步驟一步一步設定，大致上都能完成。祝好運。

結語 / Conclusion

本篇講述了如何使用Cloudflare Tunnel內網穿透來讓Home Assistant可以被GCP連接，進而實現能在手機的Google助理上操控智慧設備的目的。

這個目的到底是什麼呢？其實也只是能夠用語音操控「OK Google，關閉客廳燈光」而已。為了實現這個目的，背後需要仰賴非常多且不同的服務，而且設定的細節也會不斷改變。儘管我已經把整個設定建構完成，但考慮到所花費的時間、以及未來的可維護性，這讓我再次反思語音操控的必要性。

如果是你的話，你會怎麽選擇呢？

1. 主要重點還是在能用Google助理來操控Home Assistant，這可以延伸出很多變化，因此很值得。
2. 用Home Assistant Cloud，每年付65美金，就能省下這篇文章所要做的所有事情喔。
3. 直接在手機上操控Home Assistant不是更快嗎？
4. 我連出聲或動手都不想做，用感應器自動判斷吧。
5. 其他：你有什麼其他想法，歡迎在下面留言分享喔！

希希助教祝各位同學中秋節快樂！ / TA. Sissi Wishes Everyone a Happy Mid-Autumn Festival!

2025-10-06T12:00:00.006+08:00

與家人團圓之後，做好開學的準備了嗎？新學期也要加油喔！

AI藝術字 / AI Art Font

字型的部分並不是使用AI繪圖，而是來自真實的字型。

印章文字：汉仪新蒂唐朝体 - Hanyi Senty Tang Type
https://www.sentyfont.com/sentytang.htm
春聯題字：汉仪新蒂春联体 Hanyi Senty Spring Brush
https://www.sentyfont.com/springbrush.htm

本來一開始我也是想用AI繪圖來產生文字，但實際上用起來，Bing的英文文字能夠順利畫出來，但中文字就成了奇妙的字體。

這點ChatGPT也一樣。毛筆字看起來很厲害，但這到底在寫什麼呢？

研究了半天，還是回來用字型好了。

看電腦覺得疲憊嗎？比起螢幕，你更應該注意炫光的問題 / Are You Tired of Looking at the Computer? Pay More Attention to Glare Than the Screen

2025-08-25T12:00:00.007+08:00

說到人體工學這件事情，我想講一下燈光的問題。作為租屋族，我發現大部分租屋環境的燈光都不太適合長時間使用電腦。這個問題有兩個層面：一個是螢幕前的光線不足，另一個是螢幕後的光線不足。瞭解這兩種燈光的問題，才能改善眼睛疲勞的狀況。

Speaking of ergonomics, I want to talk about lighting. As a renter, I've found that the lighting in most rentals isn't suitable for prolonged computer use. There are two aspects to this problem: insufficient light in front of the screen, and insufficient light behind the screen. Understanding these two lighting issues is key to improving eye strain.

(這篇本來是2022年發佈在Facebook粉專上的文章，但實在是太多人都有同樣的問題，我想還是在Blog再重發一次好了，這樣也比較好找。)

螢幕前的光線：掛燈幫助有限 / Screen Light: Desk Lamps Offer Limited Help

https://youtu.be/0pUtp0xL4Tk

說到不夠亮，大部分的人想到的都是螢幕前的光線不足，然後想到的是可以用螢幕掛燈來解決這個問題。

https://www.kinyo.tw/products/pced855

令人覺得弔詭的是，螢幕本身就會發光，那為什麼我們還需要螢幕掛燈？我買了螢幕掛燈後，發現螢幕掛燈主要只有改善「桌面」的照度。我的桌面有八成都只有鍵盤跟滑鼠。而我打字操控滑鼠，又不太需要低頭操作。螢幕掛燈的確有讓我的螢幕前變亮了些，但改善的幅度相當有限。反而螢幕掛燈有時候調整不好會造成螢幕反光，反而帶來更多眩光問題。

螢幕周圍太暗帶來對比炫光的問題 / Contrast Glare from Dark Surroundings Around the Screen

另一個很少人注意到的問題是螢幕後的光線不足。「眩光是什麼？5個方法改善眩光問題」這篇提到了三種炫光種類：直接炫光、反射炫光、跟對比炫光。螢幕後光線不足，造成的結果就是「對比眩光」。

https://www.soft4fun.net/product-test-report/benq-wit-lamp.htm

造成對比眩光的原因主燈跟背景的明暗對比過大，更容易造成眼睛的疲勞。最常見的就是螢幕本身很亮，可是背景很暗，這樣非常容易造成眼睛的疲憊。上圖的例子就是一個很明顯的對比炫光案例。

https://www.ikea.com.tw/zh/products/luminaires/floor-lamps/tagarp-art-50486396?gclid=Cj0KCQjw4omaBhDqARIsADXULuVQuU44rWVqTDzPTXih67790Qn_aQaPRrF9sFxr-q6f9JvTMqVdbf8aAtO9EALw_wcB

我以前也有試著在桌上架設檯燈，但每次都讓我覺得眼睛更不舒服。現在才知道，這就是對比炫光的問題。後來我的解決方法是買一盞上照落地燈。不是往下照的檯燈，因為檯燈只會加劇對比眩光，我的目的是讓整個房間變亮。

https://www.youtube.com/watch?v=PTyBt8KqVL0

IKEA的落地燈真的解決了我的困擾。而且落地燈的支柱是分多節組裝，我少裝兩節，它放在桌上就很剛好了。

此外，讓螢幕周圍盡可能呈現跟螢幕相同的亮度，例如用白牆、白色簾子遮蓋、減少陰影，這樣也可以減少對比炫光帶來的影響。

結語：工作桌燈光佈置的考量 / Conclusion: Considerations for Desk Lighting Placement

我現在工作時通常會同時開啟螢幕掛燈跟落地燈。其中落地燈真的改善了整個工作的環境。沒有開落地燈的話，我很快就會覺得眼睛痠、無法繼續工作。但開了落地燈、照亮房間之後，我會覺得整個人舒適很多。

當然，很多人就是不希望家裡的燈光太亮。如果亮的跟辦公室一樣的話，那回家不就沒有放鬆的氣氛了嗎？呃，對，我得說這幾乎是我個人，以及少部分需要在家裡工作的人才會有的問題。

氣氛燈跟工作照明的實用時機不同 / Practical Uses of Mood Lighting and Task Lighting

https://www.youtube.com/watch?v=7vMIsKNAvUs

有些人主張應該在背景裝氣氛燈。就是不太亮、有多種顏色的那種燈。最好能夠隨著電腦狀態、音樂的播放同步改變顏色。

前面提到的對比眩光是因為前景(螢幕)跟背景(房間)的光亮程度差異過大，造成讓人眼睛疲憊的炫光現象。為什麼大家會使用跟一般燈泡暗很多的氣氛燈，還主張在這種環境下長時間使用電腦呢？

這個問題經過我長時間的思索，其中一個可能是：大家的螢幕並不是顯示高亮度的畫面。舉例來說，我需要讀paper跟寫文件，PDF跟編輯器的背景大多都是白色底，整個螢幕就會很亮。但如果是玩遊戲、看電影，那大家的螢幕就不會這麼亮。這時候如果背後的燈光太亮，反而才會造成落差。

所以結論就是，這是不是又是我個人的問題啊...？

你有使用電腦時光線不足的問題嗎？

你都是怎麼解決的呢？

在下面跟大家分享吧！

為何桌前打字總是腰痠背痛？桌子高度和螢幕高度對人體工學的影響 / The Effect of Desk and Monitor Height on Ergonomics: Why Does Typing at a Desk Often Lead to Back Pain?

2025-08-18T12:00:00.007+08:00

自從買了螢幕支架之後，我開始對所謂的「人體工學」完全改觀了。我認為比起購買昂貴的「人體工學椅」，調整合適的桌子高度跟螢幕高度，可能才是解決你腰痠背痛的關鍵因素。

Ever since I bought a monitor stand, my entire perspective on "ergonomics" has completely changed. I think that adjusting your desk and monitor to the proper height is probably more key to solving your back pain than buying an expensive "ergonomic chair".

(這篇本來是2022年發佈在Facebook粉專上的文章，但實在是太多人都有同樣的問題，我想還是在Blog再重發一次好了，這樣也比較好找。)

椅子不是人體工學的全部 / Chairs Are Not the Whole of Ergonomics

對於我們這種時常坐在辦公桌前面的工作者來說，談到人體工學，你會想到什麼呢？很多人直覺上應該想到的是「椅子」吧。「人體工學椅」，「人體工學」四個字明明白白地寫在上面了。

https://www.youtube.com/watch?v=_uFc5MyV6ag

但我最近研究的結果是：椅子反而是最不重要的一塊。

因為普通的一張摺疊椅，有靠背，椅墊到地板的高度大概在45cm左右，大概都可以滿足「雙腳平放在地面」、「背部稍微有依靠」的最低需求。

當然，更高級的椅子坐起來更舒適，但它並不能改善你的腰痠背痛。

大家應該都知道，腰痠背痛的原因是來自於坐姿不正確。說到坐姿不正確，大家應該都會想到的是椅子不夠人體工學。一把好的椅子的確可以讓你坐得端正，不過很遺憾的是，我們工作時並不只是坐在椅子上。

我認為影響辦公人體工學的兩個關鍵因素：桌子高度跟螢幕高度。改善這兩個因素，就能夠改善90%腰痠背痛的症狀。

桌子高度才是人體工學的關鍵 / Desk Height Is Key to Ergonomics

https://youtu.be/_uFc5MyV6ag

第一個要克服的是聳肩的問題：

1. 桌子的高度應該在65公分高

標準辦公桌的高度是75公分高，但這個高度其實是造成你聳肩的元兇。如果是寫文件、看文件，75公分相對合理，但以打鍵盤、操作滑鼠來說，75公分真的是太高了。根據我的觀察，就算是200公分高的人，75公分的桌子也還是聳肩。(有人主張45公分高的茶几就能工作，我得說，放過那些孩子吧。)

研究下來，我認為理想的桌面高度大概是65公分高。

很多人以為要把桌面高度降到65公分就只能去買升降桌，這也是謬誤。有些兩節式升降桌最低高度還是75公分，只有更貴的三節式才有機會降到65公分。

https://www.ikea.cn/cn/zh/p/bekant-bei-ken-te-you-ce-zhuan-jiao-shi-ban-gong-zhuo-bai-se-hei-se-s39222533/

不過就算不買升降桌，用心一點還是可以找到65公分高的桌子。IKEA BEKANT轉角桌能夠手動調整桌子的高低，最低就是65公分。

https://www.ergomap.com.tw/product/kt_ez33/?utm_source=Google%20Shopping&utm_campaign=Google%20shopping%20product%20feed&utm_medium=cpc&utm_term=2966&gclid=Cj0KCQjw4omaBhDqARIsADXULuU0dgQuK2Se3EMf6jQboitAld6-S-Fk3Tmu_EZ1ByfCS18AXtW0APMaAk_kEALw_wcB

一般做法大多都是安裝鍵盤支撐架，讓桌面下方加上一塊鍵盤滑鼠擺放的層架。
但鍵盤滑鼠的操作空間會變得很侷促，人又必須坐得離桌面更遠一點才行。

螢幕高度造成駝背的問題 / Screen Height Causes Hunchback

就算桌面成功降低，讓你打字不再聳肩。我們還要克服第二個問題：駝背。

2. 螢幕高度應該要讓你不用低頭或彎頭

現代很多人都用筆電取代桌上型電腦，整個人只能駝背打字、看螢幕，這當然不好。但外接了螢幕，螢幕支架通常也不夠高，導致很多人看螢幕還是繼續駝背。特別是如果我們把桌子降低到65公分，那就會讓螢幕的高度更矮了些。

https://store.raymii.com.tw/pages/raymii-monitor-arm-guide

這時候，螢幕支撐架就是不可或缺的關鍵設備了。

我以前大多用墊箱子或架子來架高螢幕，但是一來這樣架螢幕不太穩，二來是不太容易調整到理想高度，最後就是墊高的架子跟箱子非常佔桌面空間。

這時候花些錢買個螢幕支撐架，真的可以大副度改善上述狀況。我們很容易可以把螢幕高度跟角度調整到合適的位置。

https://www.ergotron.com/tools/workspace-planner

那話說回來，什麼是螢幕合適的位置呢？

很多人都說是「螢幕上緣應該跟視線齊平」，但事實上那是使用15吋螢幕的時代才會用的基準。我主要使用的螢幕都是24吋，很多人的螢幕都比我大得多。如果你平視只能看到螢幕上緣，那表示你得低頭才能看到螢幕其他部分。

根據我的經驗來看，我們要把握的原則仍然是「不要駝背」跟「盡可能讓眼睛直視前方」。以我24吋的螢幕來看，我的水平視線會在螢幕上面量下來的1/3，也就是說螢幕稍微比我本人坐著的時候還要高一點。這樣子的配置下，我的頭可以保持水平，不需要大副度擺動，眼球也只要稍微上下就能掌握整個桌面的狀態。而且這個高度配置會引導我維持正確的坐姿，不會低頭，也不會駝背。

不是買椅子就能解決人體工學的問題 / Ergonomics Is Not Solved by Buying a Chair

根據我的觀察，坐辦公桌抱怨腰痠背痛、手腕痛的人，有9成都沒有做到上述兩點，剩下那1成是真的坐太久了。

https://forum.gamer.com.tw/C.php?bsn=60030&snA=507763

這些人之中，有八成的人會以為是椅子的問題，轉而去買人體工學椅。
大部分人體工學椅的賣家都會斥責你坐姿不對，只有坐好椅子，你才能擁有正確坐姿。

但桌面問題不改善的話，人體工學椅引導你正確的坐姿，會跟不正確的桌面配置相互衝突，導致腰痠背痛的狀況更加明顯。

https://www.youtube.com/watch?v=hM2AL7XUoHg

有三成的人認為買升降桌來站著工作可以解決這個問題。殊不知，站著工作還是會遭遇上面兩個因素：桌子高度導致聳肩，螢幕高度讓你駝背。此外還會延伸其他問題。

大概會有七成的人會說你應該要站起來動一動，不要一直坐著。或著是什麼核心肌群不夠有力，身體肌肉不足才無法抵抗疼痛。這些人認為坐辦公桌的各種疼痛是必要之惡，無法避免。也就自然沒有想過要去改善聳肩跟駝背的根本元兇。

至於為什麼上面的幾成幾成好像加起來超過10成，那是因為大多數人都會抱持複數的解決方案。例如「要改善痠痛問題，必須要買人體工學椅，然後不要常常坐著」。

嗯？是不是邏輯上看起來怪怪的？

結語：偽人體工學設計反而傷身體 / Conclusion: Pseudo-Ergonomic Designs That Hurt the Body

https://finance.ettoday.net/news/732267

自從研究這個議題之後，我覺得自己整個人變得超級草莓。

大部分的桌椅配置，每次看都覺得這裡痛、那裡痛。光是上面這張職場示意圖，我們就可以看出許多問題：桌子太高了導致人體肩膀往上擡，會傷到肩膀跟脖子；座椅無法坐到底，讓坐姿的力量無法分散到腰、大腿和腳底。而且這種辦公椅會滑動，你要用腰和腿來固定身體，會給腰帶來更多負擔。

https://shopee.tw/%E3%80%90%E7%A7%91%E6%8A%80%E5%B8%83%E6%96%99%E3%80%91XpanseD001%E6%B7%B5%E7%81%B0-%E9%9B%BB%E7%AB%B6%E6%A4%85%E4%BA%BA%E9%AB%94%E5%B7%A5%E5%AD%B8%E6%A4%85-%E8%A8%98%E6%86%B6%E6%B5%B7%E7%B6%BF-%E9%9B%BB%E8%85%A6%E6%A4%85%E8%BE%A6%E5%85%AC%E6%A4%85%E9%81%8A%E6%88%B2%E6%A4%85-%E5%8D%87%E9%99%8D%E6%97%8B%E8%BD%89%E6%A4%85-i.33230814.24789090925?sp_atk=27778689-53e5-4f1c-b24f-f2177c23486a&xptdk=27778689-53e5-4f1c-b24f-f2177c23486a

另一方面，很多人體工學椅的展示影片，我光看就覺得身體開始痛了起來。上面這張椅子坐深太深了，模特兒無法坐到底，於是只好翹腳或盤腿，這樣會加重對腰部的傷害；左右扶手太寬了，模特兒如果要靠手，就得要張開雙臂或讓姿勢傾斜，這也會對脊椎和肩膀造成傷害。

現在一堆人追求電競椅、人體工學椅、升降桌什麼的，就讓人覺得更加無奈...

這段期間試坐了一堆人體工學椅，沒有一把比我這張六百元的摺疊椅更不會讓我腰痛。到最後拯救我坐姿的，還是高度65公分的桌子，以及抬起我螢幕的支撐架。

https://youtu.be/I2hvD9Y2CbA

如果想要獲得正確的人體工學知識，真的應該多看看三個字物理治療的介紹。解決根本原因才是克服腰痠背痛的正確做法，針灸跟推拿只是治標不治本而已。

你有坐辦公桌坐到腰痠背痛的經驗嗎？

你都是怎麼克服的呢？

歡迎下面分享~

行動網路無法連線？三星手機簡易解決方案 / Mobile Network Not Connecting? Easy Solutions for Samsung Phones

2025-08-11T12:00:00.007+08:00

如果手機無法連上4G或5G網路，除了重開機或短暫切換成飛航模式之外，還可以將SIM卡的網路模式暫時切換，讓4G或5G網路斷線後重連，這樣就可以讓行動網路重新運作了。

If your phone can't connect to a 4G or 5G network, besides restarting your phone or briefly switching to airplane mode, you can also temporarily switch the network mode of your SIM card to disconnect and reconnect to the 4G or 5G network. This can get your mobile network working again.

問題說明 / Issue

我使用的手機是Samsung XCover6 Pro，作業系統是Android 14、One UI 6.1。今天出門的時候赫然發現手機沒辦法使用行動網路了。確認了合約依然生效、通訊商的行動網路也正常之後，打電話向客服求救。

客服耐心地指示我怎麼處理問題，而這的確也很有幫助，因此我也在這裡把做法整個敘述一次。

解決方法 / Solution

首先進入手機的「設定」，然後進入「連接」。

進入到「行動網路」。

找到無法連線到行動網路的SIM卡，例如我的是SIM1。點選它的「網路模式」。

原本我是用4G連線，現在要先改成沒有4G的模式，也就是「3G/2G(自動連線)」。

就這樣稍待片刻，大概5秒鐘。

再用同樣的方法切回到有4G的網路模式。

行動網路終於可以恢復正常連線了。

其他解決方案 / Other Solutions

https://www.storm.mg/lifestyle/5302590

如果你無法使用這個方法來解決問題，網路上的「為何手機有訊號卻無法上網？一文教你5種方法解決」跟「手機有訊號沒網路 iPhone 難題超快解決！」還有建議其他的做法：

重新開機。
開啟飛航模式，讓行動網路暫時中斷，然後再關閉飛航模式恢復連線。
關閉行動網路，讓行動網路暫時中斷，然後再開啟行動網路恢復連線。
iPhone可以使用「重置網路設定」，請看「如果 iPhone 或 iPad 無法連線到 Wi-Fi 網路」的「7. 重置網路設定」。

最後就是去詢問電信供應商的客戶服務了。

中華電信：0800-080-123(中華市話、行動直撥123)
遠端FET：0800-058-885 (免費)、遠傳手機直撥 888 (免費)
台灣大哥大：0809-000-852

希望這些做法對大家有所幫助。

實作相容OpenAI API，但背後不是OpenAI的API服務 / Implementing OpenAI API-Compatible Services, But Not Powered by OpenAI

2025-08-04T12:00:00.006+08:00

我們上次談到了不是背後說用到OpenAI模型的API不見得能相容OpenAI API，那我們這次就來做個能夠相容於OpenAI API的服務，但只會回答「喵」的「喵型語言模型」。

Last time we talked about how not all APIs that claim to use OpenAI models are necessarily compatible with the OpenAI API. This time, let's create a service compatible with the OpenAI API, but it only responds with "Meow." We'll call it the "Meow Language Model."

系統架構 / System Architecture

整個架構會由五個元件所組成：

Python程式碼：不管你傳送什麼資訊，它只會回「喵」。
Dify：AI應用程式框架的Dify裡面，可以用Code節點讓我們執行這段Python程式碼，然後把它包裝成Chatflow API。
dify2openai：fatwang2開發的dify2openai將Dify的API模擬成OpenAI API格式。
Cloudflare Tunnel：將運作在本地的API服務連接到Cloudflare提供的臨時網址上。
FastGPT：使用自製的OpenAI API。

程式碼 / Source Code

https://github.com/pulipulichen/practice-Dify-OpenAI-API-2025.git

相關程式碼放在「practice-Dify-OpenAI-API-2025」保存庫裡面。這些程式碼是以Linux作業系統為主要環境，需要搭配Docker才能運作。這些程式碼並非給普通使用者執行，而是給開發者作為參考的資料。如果環境設置正確的話，執行 startup.sh 就能完成整個設定。

以下概述整個系統中需要設定的關鍵部分。

1. Python: Dify裡面的聊天流 / Python: The Chatflow in Dify

首先，我們在Dify中建立一個Chatflow，用來實作「喵型語言模型」。你可以用我事先準備好的DSL檔案來建立。DSL檔案的下載網址如下：

https://pulipulichen.github.io/practice-Dify-OpenAI-API-2025/dify-dsl/Cat_LLM.yml

我們可以看到應用程式裡面的「Code」揭露了「喵型語言模型」的秘密。

2. Dify：API的發佈 / Dify: Publish API Service

我們從「Publish」保存建立好的聊天流(chatflow)。

從左邊的「Monitoring」找到Backend Service API的「API Key」按鈕。

按下「Create new Secret key」，然後Dify會建立一個隨機的API Key，例如：「app-wUJxFJBqbPhZLUwkxGoI2qJQ」。我們複製它即可。

3. Dify2OpenAI：API轉換 / Dify2OpenAI: API Adapter

https://github.com/pulipulichen/practice-Dify-OpenAI-API-2025/blob/main/dify2openai/docker-compose.yml

dify2openai的設定我已經在docker-compose.yml設定完成。它會連結Dify的服務(主要是Dify用來對外顯示網頁的nginx)，只要輸入正確的API Key就能順利呼叫。在我預設的設定下，dify2openai會模擬成OpenAI的o1模型。如果需要修改的話，可以在 .env 環境變數裡面宣告。

如果在瀏覽器輸入dify2openai預設的網址： http://localhost:18081 ，就會看到正常顯示的樣子。

4. Cloudflare Tunnel：將API轉換成公開網址 / Cloudflare Tunnel: Converting API into Public URL

我在startup.sh腳本裡面使用了Cloudflare Tunnel將dify2openai的網址連接到了Cloudflare上。Cloudflare Tunnel會隨機分配一個網址，例如「 https://exam-therapist-disclaimer-compromise.trycloudflare.com 」。每次連接所獲得的網址都不一樣。

5. FastGPT：使用API / FastGPT: Using the API

https://cloud.tryfastgpt.ai/account/thirdParty

接著我們到FastGPT裡面。FastGPT的Third Pary account可以讓我們設定OpenAI/OneAPI account，而在這之中我們可以設定API Key跟BaseUrl。API Key就是從Dify取得的API Key，而BaseUrl則是剛剛連接到Cloudflare Tunnel的網址，並在路徑上加上「/v1」，例如「https://exam-therapist-disclaimer-compromise.trycloudflare.com/v1」。

接著便可到Studio建立應用程式，模型選用OpenAI的o1。此時使用的o1模型其實是連接到Dify的「喵型語言模型」，因此不管使用者講什麼內容，模型一律都只會回「喵」。

如此一來，我們製作的相容於OpenAI API的「喵型語言模型」就打造完成了。這應該比花50美元打造蒸餾模型還要便宜喔？(誤)

結語 / Conclusion

這篇的做法的重點並不是在「喵型語言模型」，而是「能夠跟OpenAI API相容」的這一個特性。只要能將你的服務封裝成OpenAI API的相容格式，那麼就能將它跟目前大多數主流系統相互整合。

舉例來說，以為我們雖然可以用LightRAG打造更先進的RAG架構，但打造出來的結果卻難以跟其他系統整合。現在我們有這一套Dify跟Dify2OpenAI轉換的做法，那就可以利用Dify的靈活性，將LightRAG結合到Dify的Chatflow裡面，最後就能整合到任何支援OpenAI API的系統上。

當然，Dify2OpenAI實際上只實作了OpenAI API的大型語言模型接口，並沒有實作全部的功能，它也不能完全替代OpenAI API。儘管如此，能將我們製作的「喵型語言模型」整合在其他系統上，其實就有很多應用價值了。

這篇介紹如何打造OpenAI API相容服務的文章就到此為止了。文章的最後要來問大家的是，這個OpenAI API你認為還有什麼值得注意的價值呢？

1. 蒐集與記錄使用者的對談記錄。
2. 可以加上一些自訂的規則。
3. 跟客製化的RAG整合。
4. 背後介接Google Gemini模型。這難道是AI界的NTR？
5. 開發「汪型語言模型」。
6. 其他：歡迎在下面留言，分享你的看法吧！

雜談：生活小技巧之用魔鬼氈避免機車鑰匙脫落吧 / Talk: Use Velcro to Prevent Your Motorcycle Key From Falling Off

2025-08-01T12:00:00.008+08:00

這幾天騎機車騎到鑰匙居然整個掉出來了，這該怎麼辦好呢？

鑰匙孔鬆動的問題 / Loose Keyhole Problem

摩托車使用一段時間之後，似乎就很容易遇到鑰匙孔鬆動的問題。原本機車鑰匙在轉到可以發動的位置後，鑰匙應該會卡住、不能拔出。不過現在我的機車鑰匙孔，即使是轉動到可以發動的位置、並且在啟動中，鑰匙還是可以拿出來。

我本來想說，鑰匙雖然可以拔出來，但放著不動鑰匙也還是會插在裡面，應該沒差吧。結果上次騎車的時候我膝蓋碰到鑰匙，它就這樣掉了下來。嚇得我趕緊停到路邊，把鑰匙收好。

可能原因 / Possible Causes

https://www.mobile01.com/topicdetail.php?f=266&t=2376250&p=9#31045150

有這樣問題的網友並不在少數。根據「[問題] 機車行進中鑰匙可以拔出」這篇的討論，造成機車鑰匙鎖頭鬆動、無法固定鑰匙這個結果的原因，不外乎以下幾點：

鑰匙過重：大多數的人都擁有多把鑰匙，而機車孔上插著鑰匙時掛著一大串其他物品，會讓鎖頭的彈簧承擔過重的負荷，最後導致無法固定。
路面不平：騎車的路徑不斷上上下下的晃動，也會使得鑰匙持續甩動，最後讓鎖頭變鬆。

解決的方法 / Solution Method

解決鎖頭鬆動這個問題的做法大致上分成三種：更換鎖頭、更換鑰匙、取出、防掉落。

https://www.youtube.com/watch?v=vE3v_pNJV_Y

第一種更換鎖頭做法可能是根絕問題的主要方法。不過更換鎖頭的安裝和維修並不容易，建議是到機車行處理，一般人應該比較難自行更換。

https://disp.cc/b/Motorcycle/dQYF

費用的部分，網友Dcpp2015提到可能超過1000左右。但每臺機車可用的零件價格應該不太一樣。

第二種做法是在鑰匙上。有人認為可能是因為鑰匙磨損導致無法固定在鑰匙孔裡。比較簡單的做法就是再換一隻鑰匙，費用自然也比更換鎖頭還要便宜許多。不過如果是鎖頭本身已經鬆脫的話，更換鑰匙也無法解決問題。

https://disp.cc/b/Motorcycle/dQYF

operatorm提議可以讓鑰匙店打一隻加厚的鑰匙。不過我不確定鑰匙店能不能這樣做。

第三種做法是在機車發動之後，先把鑰匙收起來，以免它行進中掉落。這可能也是避免機車鑰匙丟失的好做法。不過這樣騎機車的操作就多了兩個手續，有點繁瑣。

https://disp.cc/b/Motorcycle/dQYF

最後一種做法是用各種方法勾住鑰匙，避免騎車時鑰匙直接掉落在路邊。cyuan0301的建議是將鑰匙的吊繩掛在機車內建的吊掛鉤子上，這樣至少可以在鑰匙鬆脫的時候有機會仍掛在鉤子上。

https://www.buybike.com.tw/04-%E9%9A%B1%E8%97%8F%E5%BC%8F%E9%98%B2%E8%B7%B3%E8%84%AB%E6%8E%9B%E5%8B%BE/

就算是本來沒有鉤子的機車，有人也會為了避免鑰匙鬆脫而特地裝個鉤子來掛鑰匙。有些人更喜歡裝上圖這種可以合起來的防脫落掛鉤，這比開放式的掛鉤更穩定。不過這也讓騎機車的操作變得更加複雜就是了。

防掉落的取捨：魔鬼粘 / Drop Prevention Trade-off: Velcro

那麼，在防止掉落的做法上，如果沒有鉤子的話，那有沒有什麼簡單、又能夠固定鑰匙的做法呢？魔鬼粘可能是一個折衷的方案。

安裝 / Setup

我在機車鑰匙孔旁邊貼了一個2公分的小型魔鬼粘。機車面板上貼著的是刺面、帶鉤子的那一面，另一面毛面則粘在鑰匙吊繩上。

我加上釘書針來固定魔鬼粘的毛面，這樣可以確保毛面不會掉落。

使用 / Usage

用魔鬼粘來固定的話，使用時操作起來就很簡單，只要將吊繩的毛面壓到機車的刺面就能固定。不要看魔鬼粘的尺寸只有2公分而已，這已經足夠固定鑰匙本身的重量，就算整個鑰匙掉落，魔鬼粘還是可以抓住整個鑰匙。

取出鑰匙的時候，則需要出力將吊繩扯出來。一開始常常忘記鑰匙的吊繩還粘在魔鬼粘上，導致收鑰匙的時候覺得不太順手、覺得很卡。後來習慣了就還好。

小結：魔鬼粘是理想的做法嗎？ / In Closing: Is Velcro the Ideal Approach?

https://shop.showba.com.tw/SalePage/Index/7803780

這個在小北百貨購買的20元魔鬼粘，的確一定程度上解決了我的機車鑰匙鎖頭鬆脫而掉落的問題。不過魔鬼粘的做法本身仍有幾個可能的隱憂需要注意：

魔鬼粘的固定力道真的足夠嗎？儘管鑰匙自然掉落的情況下，魔鬼粘確實有足夠的力道可以抓住整個鑰匙，不過如果是遇到激烈晃動、甩動的狀況，魔鬼粘夠用嗎？
魔鬼粘與機車外殼的粘貼處足夠牢靠嗎？我使用原本魔鬼粘背後的粘膠黏在機車上，不過這種粘膠在機車日曬雨淋的狀況下，很難確保它是否能夠維持原本的粘性。這點需要經過時間觀察。

不管怎麼說，目前在成本和便利上，魔鬼粘的做法只能說是取得了一定的平衡。未來使用一段時間之後，可能還是要再來評估看看這是否合適吧。

AdGuard Home不只是拿來擋廣告 / AdGuard Home Is More Than Just an Ad Blocker

2025-07-28T12:00:00.008+08:00

自從裝起了AdGuard Home來擔任我住處的DNS伺服器之後，我用它擋掉了很多奇怪的廣告。除此之外，它還能拿來自訂Domain Name，真的是太實用了！

Since I set up AdGuard Home as the DNS server for my place, it has blocked a lot of weird ads. Besides that, it can also be used for custom domain names, which is really practical!

AdGuard Home

https://adguard.com/zh_tw/adguard-home/overview.html

AdGuard Home 是一款免費開源的全網路廣告和追蹤器阻擋軟體（Network-wide ad and tracker blocking software）。它作為一個 DNS 伺服器（DNS Server）運作，將追蹤網域重新導向至一個「黑洞」（Black hole），進而防止你的裝置連線到這些帶有廣告或危險的伺服器。

AdGuard Home 不僅可以阻擋網頁和應用程式中的廣告及追蹤器，還能保護你的隱私和資料，進而加快網頁載入速度。它支援 DNSSEC（域名系統安全擴充, Domain Name System Security Extensions），提供可自訂的過濾清單和家長控制功能。你可以透過網頁介面或手機應用程式輕鬆管理過濾程序。此外，AdGuard Home 也提供 Docker（軟體容器化平台）安裝方式，方便在不同平台上部署。

AdGuard Home的安裝與設定 / Installing and Configuring AdGuard Home

https://adguard.com/zh_tw/adguard-android/overview.html

一開始是我朋友推薦我在手機安裝AdGuard，說可以防止手機連上廣告網站。我看了看AdGuard的原理，想說弄個DNS伺服器好像也不難，而且中國大陸那邊很多網友也都會架設AdGuard來作為居家資安的第一道防護，那我也來架設看看好了。

https://github.com/AdguardTeam/AdGuardHome?tab=readme-ov-file#getting-started

佈署AdGuard Home的方式很多，我參考了「Install AdGuard on Ubuntu 20.0.4 using Proxmox and one line of command」這篇的做法，使用的是自動安裝腳本安裝。我在Proxmox VE裡面建立CT容器，作業系統是Ubuntu 22.04。安裝AdGuard Home的自動腳本如下：

curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

https://youtu.be/2AJbAcGVwlA

第一次安裝完後，連上AdGuard Home伺服器的網址，會出現初次佈署的設定。

參考佈署說明設定完之後就可以登入AdGuard Home了。

建立好AdGuard Home之後，我把家裡路由器的DHCP中DNS伺服器的設定改成AdGuard Home的網址。

然後確認我透過DHCP連線的裝置，DNS使用的是AdGuard Home伺服器。

接著在AdGuard Home的Query Log裡面，就可以看到裝置連上網路查詢的DNS。

有些可能是廣告的網址就會被AdGuard Home擋下來。這樣就初步設定完成了。

要用那些禁用清單？ / Which Banned Lists Should Be Used?

AdGuard Home的原理是設定一堆黑名單來阻止裝置連上黑名單的網站，而這個黑名單其實是由不同單位各自維護與管理的清單。在DNS blocklists裡面我們可以看到很多不同的清單，有勾選套用的清單，AdGuard Home就會把清單裡面的規則加入黑名單。

一開始我嘗試把所有清單都勾選，但很快我就發現網路無法正常運作。全部勾選之後，我自己的Blog「布丁布丁吃什麼？」會無法開啟，而且巴哈姆特動畫瘋也會因為無法播放廣告而進入不了動畫本身。可能是某些清單包含了過於激進的擋廣告策略吧，這樣下去可不行。所以現在我只有勾選預設的AdGuard DNS filter而已。

擋掉聯想平板奇怪的查詢 / Blocking Strange Queries from Lenovo Tablet

在觀察Query Log的時候，我發現聯想的平板一直在跟「lenovomm.com」網域的伺服器連線，而且連線的頻率非常頻繁。我感覺這不太像是系統更新的檢查，更像是平板自動傳送訊息給遠端的伺服器。

於是我在Custom filtering rules裡面，將平板持續傳送的這些網域禁止掉。後來看起來平板似乎也沒有什麼異狀。

不過如果可以的話，我還是希望能將平板裡面奇怪的新聞查詢功能也一起關掉。可惜現在我還找不到怎麼在AdGuard Home阻止它們。

自訂Domain Name / Customize the Domain Name

https://youtu.be/KdxGklRyx5E

AdGuard Home還一項特殊功能：DNS Rewrites。

我們可以自行設定IP跟Domain Name，而這個Domain Name只有使用AdGuard Home作為DNS的裝置才能正確識別。

如此一來，我們就可以用自訂的Domain Name連線。這樣我們就可以用比較容易的Domain Name來稱呼設備，未來就不用記IP數字了。

結語 / Conclusion

其實當初我買Router OS的其中一個原因是聽說它可以裝AdGuard Home。不過我看了「RouterOS 使用容器搭建 AdGuard Home」這篇的說法，原來它是將AdGuard Home用container的形式安裝到Router OS，整個操作頗為複雜。因此我才決定改用Proxmox VE來佈署AdGuard Home，整個程序就簡單很多。

在AdGuard佈署的過程中我還犯了很多錯。像是把8.8.8.8當作是第二Name Server，結果被AdGuard Home擋掉的網站通通都從8.8.8.8查了回來。結果就什麼也沒擋到。

然而AdGuard Home只能擋掉網頁上面的佔版廣告，或是防止裝置探訪特定網域。如果是應用程式裡面結合的廣告，通常都不能把它擋下。例如YouTube的內建廣告、或是巴哈姆特動畫瘋影片前的廣告。擋掉的話就會連影片都無法觀看。

https://www.pixiv.net/artworks/119644871

儘管如此，AdGuard Home將大部分網頁上的佔版廣告擋掉的這個功能，已經幫了很大的忙了。現在看很多網站會出現莫名其妙的空白區域，或是連線錯誤的訊息。搞不好哪裡原本就是廣告的位置呢。

這篇關於使用AdGuard擋廣告跟設定Domain Name的過程就到此為止了。文章的最後要來問大家的是，你對網路廣告的看法是？

1. 還是擋掉吧。都2025年了，網頁的佔版廣告還能賺錢嗎？
2. 留著廣告吧。偶爾也會看到一些有趣的內容，讓人不禁想要點進去看看啊。
3. 有廣告嗎？我都買YouTube Premium。
4. 其他：歡迎在下面留言，分享你的看法吧！

雜談：在實體機器裡面架設虛擬機器的虛擬機器失敗 / TALK: Virtual Machine Failure Within Nested Virtualization on a Physical Machine

2025-07-25T12:00:00.006+08:00

沒想到Proxmox VE裡面的Windows無法啟動WSL2的原因，可能是因為Proxmox VE宿主機的CPU是AMD。

Windows中的虛擬機器 / Virtual Machines in Windows

為了測試Docker Desktop在Windows環境下的運作，我用Proxmox VE架設了Windows 11 Pro N作業系統，然後安裝Docker Desktop來使用。Docker Desktop需要使用Windows的WSL (Windows Subsystem for Linux)來執行Docker容器，通常安裝完Docker Desktop後，軟體會再要求Windows配置好WSL。

然而，當我嘗試使用「wsl --install」來安裝Ubuntu時，卻收到了以下錯誤訊息：

PS C:\Users\user> wsl --install
Downloading: Ubuntu
Installing: Ubuntu
WSL2 is not supported with your current machine configuration.
Please enable the "Virtual Machine Platform" optional component and ensure virtualization is enabled in the BIOS.
Enable "Virtual Machine Platform" by running: wsl.exe --install --no-distribution
For information please visit https://aka.ms/enablevirtualization
Error code: Wsl/InstallDistro/Service/RegisterDistro/CreateVm/HCS/HCS_E_HYPERV_NOT_INSTALLED

幾經調查後，似乎是因為虛擬機器本身沒有啟動硬體虛擬化功能的緣故。那接下來就要離開Windows虛擬機器，從宿主機(host)來看看可能的原因了。

Proxmox VE環境 / Proxmox VE Environment

宿主機使用的CPU是AMD Ryzen 9 7940HS。就跟現代的CPU一樣，基本上都支援硬體虛擬化的功能。

根據Proxmox VE在Enable Nested Hardware-assisted Virtualization裡面的說明，虛擬化的參數已經開啟。但因為我使用的是AMD的CPU，跟PVE說明中的Intel有點不一樣。

設定CPU / CPU Settings

說明中也提到應該讓客機的CPU使用宿主機的CPU，設定為host即可。但結果依然是無法成功。

我嘗試了網路上提到的幾種設定，不過還是無法在客機Windows裡面啟用WSL。

有許多建議跟教學，不過看起來大家使用的CPU都是Intel系列。而Proxmox VE在CPU設定裡面也有hv-evmcs可供設定，這個設定似乎可以加強客機巢狀虛擬化的功能，但只能在Intel CPU裡面使用。

小結 / In Closing

幾經研究之後，感覺似乎是AMD的CPU無法啟用巢狀虛擬化，抑或是Windows的WSL還有其他要求，可能還有我沒察覺到的細節？

總之這次嘗試算是失敗了。這篇就把過程記錄一下，看看未來有沒有辦法克服吧。

如何在Home Assistant的localTuya設定裝置的實體？ / How to Set Up Device Entities in LocalTuya on Home Assistant?

2025-07-21T12:00:00.008+08:00

要在Home Assistant裡面使用localTuya，我們除了要取得裝置的local key之外，還需要自行設定裝置的實體在Home Assistant的控制方式。以下我們就用威技除溼機WDH-11FS為例子，來看看怎麽將UVC模式設定到Home Assistant上。

To use localTuya in Home Assistant, besides obtaining the device's local key, we also need to configure how the physical device is controlled within Home Assistant. Below, we'll use the NWT WDH-11FS dehumidifier as an example to demonstrate how to set up the UVC mode in Home Assistant.

前置作業 / Preliminary Work

這篇的操作我主要想講Entity的設定，不過我們還是有必要提一下在這之前的操作。

首先，我們必須確保你的Home Assistant有正確安裝localTyua，也就是LocalTuya integration。localTuya的保存庫有寫到如何安裝，最簡單的做法是用HACS。手動安裝的教學可以參考「LocalTuya Home Assistant 使用教程」這篇的做法。安裝完成後，啟動Home Assistant，在整合裡面就可以找到LocalTuya integration。

https://www.youtube.com/watch?v=Q1ZShFJDvE0

下一步是要取得裝置的local key。這個步驟需要先讓裝置連上手機的Tuya APP，讓Tuya IoT伺服器取得裝置的資訊。接著需要你註冊並登入Tuya的IoT開發者平臺：

https://iot.tuya.com/cloud/

然後經歷一連串的設定，你要找到裝置的device_id，最後就能在API Explorer > IoT Core > Device Management > Query Device Details in Bulk裡面，用device_id找到它的local_key。整個操作非常的複雜，而且Tuya不時會更動系統的操作邏輯。我看的每個教學細節都不太一樣，最後還是要靠自己摸索才能找到。

附帶一提，如果你的裝置有經過重置WIFI的話，local_key也會跟著改變。到時候記得要再回去Tuya IoT找尋改變後的local_key喔。

如果你要控制的WIFI裝置跟Home Assistant在同一個區域網路底下，localTuya應該能夠抓到你的WIFI裝置，然後你就可以進入設定。設定裡面的Device ID、Local key都是前面步驟中找到的關鍵資訊。

但如果你繼續設定，就會發現localTuya開始問你關於實體的設定方式。通常這時候我們就會不知道該怎麼進行設定了。

實體裝置跟虛擬的「實體」 / Physical Devices and Virtual "Entities"

這裡我們要先來說明Home Assistant裡面「實體」(entity)的概念。一臺真實的除溼機上面有很多按鈕，這包括了電源開關、除溼模式、風速、定時等等。這些每一個可控制的開關、每一個負責感應與記錄數值的感應器，它們在Home Assistant裡面都會對應成虛擬的「實體」(entity)。

一般來說，經過配置好的智慧家電，通常會自己能夠告知Home Assistant自己有哪些實體可以使用。而Home Assistant會自動把它加入到系統中，你就能夠直接控制。但在localTuya裡面，這些實體得要你自己手動設定才行。

手動設定，意味著你要瞭解這臺裝置它的以下資訊：

ID，在Tuya裡面稱為「dp_id」，在localTuya裡面稱為「ID」。這是用來表示裝置上某個實體的代號。
用途，在Tuya裡面稱為「code」，localTuya裡面則是代表你設定的名稱「name」：這表示該代號的功能，例如「switch」表示電源開關。每個裝置自己的code都不一樣，需要各別去解讀。
類型，在Tuya裡面稱為「type」，在localTuye裡面就是Entity Type。這是用來呈現實體的表現形式。常用的type設定大概有這幾種：
- 它是開關的的話，Tuya會記錄成「bool」(boolean的簡稱)，在localTuya裡，可控制的實體要設定成「switch」，不可控制的感應器則設為「binary_sensor」。
- 記錄數值的感應器，Tuya會記錄成「value」，在localTuya則要設定成「sensor」。
- 多種選項中其中一種的選項，在Tyua會記錄成「enum」，在localTuya則要設定成「select」。
數值，在Tuya跟localTuya裡面都稱為「value」。這是用來表示現在該ID的狀態。
- 如果是開關類型的「switch」，大多value都是true或false。
- 感應器類型則會以數字表示。
- 多種選項的話通常會以字串記錄。

除了數值之外，ID、用途(名稱)、類型，這些都是我們要在localTuya裡面配置的參數。但我們不能光靠localTuya就知道裝置的細節，還是要上Tuya IoT網站查詢。

查詢裝置的屬性 / Query Properites of the Device

上述屬性我們要在API Explorer裡面查詢，也就是跟查詢local_key類似的位置。請按照以下步驟進入查詢：

進入Device Control。
進入Query Properties。
輸入device_id。
在Response取得結果。

我們來看一下部分Response的結果：

{
  "result": {
    "properties": [
      {
        "code": "switch",
        "custom_name": "",
        "dp_id": 1,
        "time": 1737549561825,
        "type": "bool",
        "value": false
      },
      {
        "code": "dehumidify_set_value",
        "custom_name": "",
        "dp_id": 2,
        "time": 1733855769285,
        "type": "value",
        "value": 60
      }
      // 中間省略
}

我們可以從這裡查到「dp_id」，也就是裝置各項控制或感應器的實體，例如1；然後再看到「code」，這表示實體的名稱，例如「switch」；然後我們要看看它的「type」，例如「bool」，這是boolean二元值的簡稱；最後關注到「value」，就是它實際的值。

其實我們光看code還是很難猜得到這個實體到底是什麼意思。這時候我們可以嘗試手動開關除溼機設備的各項控制器，再去觀察各個實體的變化。例如我把除溼機的開關給打開，然後再到Tuya IoT網站上去查詢。

此時dp_id為1，意思為switch的實體，數值變成了true。因此可以推測這可能是電源開關。

用類似的邏輯來看，我們也可以發現dp_id為6的實體，它其實是室內溼度的感應器。

如何查詢enum可能的value？ / How to Query Possible Values of an Enum?

比較麻煩的是UVC它的類型是「enum」，而數值是字串「low」，這又是什麼意思呢？

這時候我們就需要一邊調整可以一邊搭配控制裝置，一邊查詢API，以此瞭解實體可能的值。舉例來說，剛剛UVC模式是「弱速」，所以Tuya API的數值是「low」。現在我們把UVC模式調整為「強速」來看看。

再查詢API，你就會發現value變成了「high」。

UVC模式設為「自動」的話，value就變成了「auto」。

在localTuya裡面設定UVC模式 / Setting UVC Mode in LocalTuya

瞭解了enum的可能數值後，我們就可以回到localTuya裡面設定裝置的Entity。enum的Entity type請選擇select。

在Configure entity裡面進行以下設定：

ID設定為UVC模式的dp_id，也就是106。
Friendly name則參考code的寫法，寫上便於理解的名稱，例如「uvc」。
Valid enties裡面就得要設定「off;low;high;auto」，各別代表UVC模式的「關閉」、「低速」、「高速」、「自動」。

這樣就能將uvc新增為Home Assistant的實體，在Home Assistant裡面控制除溼機的UVC模式。我為了避免uvc名稱太容易跟其他實體混淆，我就把除溼機的全名寫了上去，看起來有點長。

威技WDH-11FS的設定 / Configuration of NWT WDH-11FS

在瞭解如何查詢裝置的API，獲得實體的設定值之後，我們就能逐步查詢裝置的細節。最後我把威技WDH-11FS裡我會用到的設定整理如下。

開關類別 / Switch

實體	localTuya: Friendly Name	Tuya: dp_id localTuya: ID	Tuya: type	localTuya: platform	localTuya: Current
除溼機電源開關	Dehumidifier NWT WDH-11FS Power	1	switch	switch	1

選單類別 / Select

實體	localTuya: Friendly Name	Tuya: dp_id localTuya: ID	Tuya: type	localTuya: platform	localTuya: Valid entries
除溼模式	Dehumidifier NWT WDH-11FS Dehumidify Mode	5	enum	select	auto;dehumidify;continuous;off
風扇方向	Dehumidifier NWT WDH-11FS swing_set	105	enum	select	off;ud;lr;all
UVC模式	Dehumidifier NWT WDH-11FS UVC	106	enum	select	off;low;high

二元感應器類別 / Binary Sensor

實體	localTuya: Friendly Name	Tuya: dp_id localTuya: ID	Tuya: type	localTuya: platform	localTyua: On Value (for binary_sensor)		localTyua: Device Class (for sensor and binary_sensor)
水箱是否已滿	Dehumidifier NWT WDH-11FS tank_full	101	bool	binary_sensor	TRUE	FALSE	safety
HEPA濾網是否需要更換	Dehumidifier NWT WDH-11FS hepa_change	103	bool	binary_sensor	TRUE	FALSE	safety

感應器類別 / Sensor

實體	localTuya: Friendly Name	Tuya: dp_id localTuya: ID	Tuya: type	localTuya: platform	localTyua: Unit of Measurement (for sensor)	localTyua: Device Class (for sensor and binary_sensor)
室內溼度	Dehumidifier NWT WDH-11FS humidity_indoor	6	value	sensor	%	humidity
PM2.5感測器	Dehumidifier NWT WDH-11FS UVC PM25	15	value	sensor	ppm	aqi

結語 / Conclusion

除溼機能夠跟Home Assistant整合嗎？大部分的商家都會跟你說，不行，只能跟我自家的APP整合，頂多是跟Google助理或Homekit整合。至於為什麼客服會這樣說，你看了我這篇的說明大概也能猜到一二，那就是Home Assistant的設定的確是複雜很多。

這篇是因為使用了localTuya的方案，不僅local_key得要自己查詢，所有的entity都得要一一查詢、設定，通常還需要多次的嘗試錯誤，最後才能找到正確的設定。

如果直接使用Home Assistant裡面的Tuya整合，那應該可以更簡單一點。但是Tuya整合要求每半年都要上平臺申請驗證，久了也覺得麻煩，所以才有了這次嘗試localTuya的打算。

雖然設定好localTuya除溼機跟自動化規則之後，我就不太需要再回去設定localTuya。但未來如果還要繼續使用localTuya方案，我肯定會忘記上面那串查詢跟設定的操作方式。還是趁自己還有記憶的時候，趕快把它記錄下來吧。

這篇關於在Home Assistant使用localTuya的教學就到此為止了。文章最後的問題是，你對於localTuya的設定過程有什麼看法呢？

1. 雖然很複雜，但設定完之後就可以不用再調整，還是蠻值得一試的。
2. 用Tuya整合就好了吧？頂多每半年去申請一次延長，還有裝置一定要連上網際網路而已。
3. 太麻煩了，有沒有更容易整合的除溼機？
4. 為什麼除溼機要整合到智慧家居？自己按個按鈕不行嗎？
5. 為什麼要用除溼機？
6. 其他：歡迎在下面留言，分享你的看法吧！

雜談：也許NAS作為NAS就好 / TALK: Perhaps a NAS Should Just Be a NAS

2025-07-18T12:00:00.008+08:00

近期在更換QNAP NAS硬碟的時候，不禁思考起我對NAS看法的轉變。

硬碟健康度出現問題 / Hard Drive Health Issues

事情是來自於我注意到NAS硬碟健康度出現警告的時候開始。

之前在工作時也碰過不少NAS，不過當時並沒有做好監控機制，幾乎都是等到整個NAS都不能正常運作的時候，我們才會注意到NAS硬碟出問題了。當然，這並不是什麼很好的做法。

我在個人使用的NAS選擇的是QNAP的小主機。這臺QNAP NAS上的硬碟配置很簡單，連RAID都沒有設。它內建的硬碟插槽只有兩個，與其硬是拿來組RAID，我的做法是將這兩顆硬碟當作各別的兩個儲存池來處理。

這次是我在登入NAS的時候注意到系統發出了硬碟健康度的警告。這個警告是來自於S. M. A. R. T. 機制，它指出這可硬碟在「Current_Pending_Sector」跟「Uncorrectable_Sector_Count」上面出現了問題。前者可能可以透過硬碟區塊修復來解決，但無法修復的區塊就會加入到「Uncorrectable_Sector_Count」，而這就是硬碟即將嚴重毀損的跡象。

https://forum.qnap.com/viewtopic.php?t=167523#top

簡單來說就是——該換硬碟了。

QNAP的Notication Center能將硬體發出的警告用Email傳送通知。不過我之前設定的Gmail授權不知不覺過期了，難怪通知也沒在正常運作。現在可得要多多注意通知了。

硬碟空間與NAS的使用 / Hard Drive Space and NAS Use

既然已經決定要把硬碟替換了，那我要做的事情，就是把快壞掉的硬碟上的資料移動到其他地方去。我買了一顆8T的硬碟，用外接USB的方式接上NAS，然後在QNAP裡面把硬碟格式化、再逐漸把檔案搬移過去。

另一方面，安裝在QNAP裡面的應用程式是不能搬移到外接硬碟，而只能轉移到安裝在QNAP裡面的另一顆硬碟裡面。藉這個機會，我也把原本在QNAP裡面架設的服務通盤了一下，將資料匯出、備份後，刪除了不使用的服務。

調整過後，有問題需要替換的硬碟佔用的空間只剩下3百多GB，另一顆同樣裝在NAS上的4TB硬碟也只用了1.86TB。看起來現在的使用量真的是綽綽有餘。倒是準備拿來替換的8TB硬碟已經使用了4.7TB，看來之後要再花些時間整理一下了。

NAS不架站了 / Giving Up on Setting Up a Website Using a NAS

在整理QNAP安裝服務的過程裡，其實還蠻令人感慨的。

剛買NAS的時候，我還期待把NAS當作網頁伺服器來運作服務。但到現在，我已經把QNAP的大部分虛擬化服務都關掉了。

由於小主機性能孱弱的關係，跑Virtualization Station的全虛擬化虛擬機器的體驗不太好。而Container Station雖然能運作門檻比較低的Docker跟LXD，但在我用另一臺電腦架設Proxmox VE之後，在QNAP跑Docker或LXD也就顯得沒那麼好用了。

原本靜態網站的架設全部轉移到GitHub Page上。而動態網頁的需求也被拆分到各個其他服務去。API服務我會用Apps Script或Vercel來實作，而各別分析的需求則是用Colab來完成。若真的要架設並運作大型系統，那就在Proxmox VE上搭配Cloudflare Tunnel內網穿透就好了，不用再勉強配一個獨立IP才能使用。

沒有公開IP的網路環境 / Network Environments Without a Public IP

另一個主要的變動是myQNAPPcloud Link也被我關掉了。這個功能是在撥接取得動態IP的網路環境下，讓QNAP能用固定的網域名稱連線的一種做法。以前我要在區域網路之外取用QNAP的檔案，就得透過myQNAPcloud來連線。

然而，我後來所在的網路環境，其實是連撥接取得動態IP的資格都沒有，純粹就是在NAT區網內用DHCP來取得區域IP而已，而且上層管理者也不給開Port Forwarding。在這個情況下，就算是myQNAPcloud也無法連線。

後來我改用ZeroTier建立虛擬內網。只要裝置連上ZeroTier加入虛擬的區域網路，彼此之間就能用IP來連線。這樣的做法甚至可以避免QNAP NAS暴露在網際網路上，減少被攻擊的危險。這也是我在QNAP的Container Station裡唯一保留運作的Docker容器。

https://blog.qnap.com/zh/%E6%8E%A8%E8%96%A6%E4%B8%89%E7%A8%AE%E9%80%8F%E9%81%8E%E5%A4%96%E7%B6%B2%E5%AE%89%E5%85%A8%E5%AD%98%E5%8F%96-nas-%E7%9A%84%E6%96%B9%E5%BC%8F/

關於ZeroTier的詳細操作可以參考QNAP的Blog「推薦三種透過外網安全存取 NAS 的方式」。

設定好ZeroTier後，即使QNAP NAS沒有公開在網際網路，我們在離開內網的時候，還是可以用ZeroTier的虛擬IP來連上QNAP NAS。這個意思是說，即使是在外面使用手機，我們依然可以用行動網路來連上QNAP，並用QuMagie備份手機的相片跟影片。

讓NAS專心做好儲存跟檢索的工作 / Let NAS Focus on Storage and Searching

撇除掉作為網頁伺服器的工作後，現在這臺QNAP NAS主要的工作就是提供NFS跟Samba區域網路硬碟的服務。它不僅僅只是讓Proxmox VE外掛成為備份資料跟保存ISO檔案的儲存空間，在Proxmox VE裡面的虛擬機器也會掛載NAS來存放檔案。這次我在架設Stable Diffusion的時候就把模型檔案跟繪圖結果存放在NAS裡面，大幅度減少了虛擬機器佔用的空間，而且也可以避免虛擬機器壞掉或關機的時候無法存取檔案。

在另一臺電腦執行程式、NAS只是作為儲存空間的做法還有很多種應用。我也將網路上看到的重要文章或資料，用SingleFile儲存成HTML檔案，並轉換成docx後，放到NAS上保存。

這個做法可以搭配QNAP的QSirch全文檢索資料庫來查找資料，效果還不錯。

https://www.qnap.com/zh-tw/software/qsirch

QNAP後來有在QSirch加上了語意搜圖的功能，不過這功能只限於搜尋圖片，還不能用於搜尋文字上。希望未來能夠結合語意向量來實現文字上的語意搜尋啊。

小結 / In Closing

https://www.qnap.com/zh-tw/product/ts-253d

這臺QNAP NAS買到現在已經有四年了。當初為了讓它能夠跑虛擬機器，我還特別把記憶體從4GB加裝到32GB。不過現在看來，好像也沒那個必要。

現在我對NAS的期望回歸到「儲存」跟「檢索」這兩個功能上。「儲存」是NAS本來就做的很好的部分，但「檢索」則是一直讓我很不滿意。

在靜待更好的技術出來之前，我還是繼續把壞掉的硬碟換掉吧。

在Home Assistant使用紅外線遙控器Moes UFO-R11 / Using Infrared Remote Control Moes UFO-R11 in Home Assistant

2025-07-14T12:00:00.007+08:00

紅外線遙控器Moes UFO-R11可以透過Zigbee2MQTT跟Home Assistant整合在一起，讓我們能夠在Home Assistant裡面直接控制冷氣、電風扇等紅外線遙控的裝置。但是UFO-R11的設定可是出乎意料之外的複雜，讓我們用這篇來記錄一下做法吧。

The Moes UFO-R11 infrared remote control can be integrated with Home Assistant via Zigbee2MQTT, allowing us to directly control infrared-controlled devices like air conditioners and fans within Home Assistant. However, setting up the UFO-R11 is unexpectedly complex. Let's use this post to document the process.

Home Assistant與Zigbee2MQTT的關係 / The relationship between Home Assistant and Zigbee2MQTT

Home Assistant (HA) 是一款開源的居家自動化平台，它內建了多種連結方式，能夠與各種智慧裝置連接。舉例來說，我們可以透過WIFI連接Tuya或Broadlink的設備，或是透過藍芽連線到SwitchBot的手指機器人。那如果我們要連上Zigbee設備的話，一般來說我們都會透過Zigbee2MQTT來居中協調。

Zigbee2MQTT，簡稱z2m，是一個將 Zigbee 裝置橋接到 MQTT 的橋接器，然後z2m會將各式各樣的 Zigbee 裝置整合到 Home Assistant 中。Zigbee2MQTT 就像一座橋樑，連線 Zigbee 裝置和 MQTT 伺服器。它將 Zigbee 裝置的資料轉換成 MQTT 訊息，讓 Home Assistant 可以讀取和控制這些裝置。透過 Zigbee2MQTT，使用者可以擺脫廠商專屬的閘道器或應用程式，自由選擇和組合不同品牌的 Zigbee 裝置，打造更彈性、客製化的智慧家庭環境。

Zigbee紅外線遙控器Moes UFO-R11 / Zigbee infrared remote control Moes UFO-R11

Moes UFO-R11是一款透過Zigbee通訊的智慧型紅外線萬用遙控器，旨在取代家中眾多的紅外線遙控器。它可以學習並發送各種紅外線訊號，控制家中例如冷氣、電視、風扇等支援紅外線遙控的電器。透過連線Zigbee閘道器(Gateway)，你可以將Moes UFO-R11整合到智慧家庭系統中，包括Home Assistant，進而使用智慧型手機App或語音助理來控制家電，提升居家生活的便利性。

Moes UFO-R11最特別的地方在於能用兩顆AAA電池來進行供電。我用過許多智慧家電的紅外線遙控器，大多數都是用WIFI連接。WIFI的高耗電量註定了這些裝置必須一直接著電線，這讓我在佈置智慧家電的時候受到了很大的限制。Moes UFO-R11使用的Zigbee協定都相當節能，因此Zigbee裝置大多都可以用電池就能獨立運作。這讓我能將Moes UFO-R11輕鬆放置在家中任何角落。

這下子萬能遙控器總算像是遙控器了，不然一直接著線非常不方便啊。

將UFO-R11加入到Zigbee2MQTT / Add UFO-R11 to Zigbee2MQTT

在使用UFO-R11之前，我們要先將UFO-R11加入z2m。

我們在z2m開啟允許讓裝置加入。

我們打開UFO-R11底下的電池蓋板，然後長按Reset按鈕。

接著Moes UFO-R11應該就能順利加入。

由於UFO-R11本身沒有指示燈，我們很難判斷UFO-R11有沒有正常啟動。如果一直沒能順利加入的話，有時候是電池的問題。我裝充電電池的時候無法順利啟動UFO-R11，但換成鹼性電池就可以運作了。

讓我們進入UFO-R11設備，把它設定一個自己容易記憶的名稱後，切換Exposes頁面。以下的操作大多都會在Exposes頁面這裡進行。

學習紅外線指令 / Learning IR Code

像是Moes UFO-R11這種學習型紅外線遙控器的操作，我們需要關注兩個重點：學習與發送。學習是學習原始紅外線遙控器發出的訊號，將它保存到設備裡面；發送則是將學習到的訊號發送給冷氣或電風扇等裝置。

開啟Zigbee2MQTT中UFO-R11的Expose。我們可以看到learn_ir_code跟learned_ir_code的資訊。前者是開啟學習功能的開關，後者是記錄學習到的訊號。我們先把這個頁面開好，然後來準備硬體的設定。

接下來拿出你的UFO-R11跟原本的紅外線遙控器。

假如我們現在要學習的是「開機」按鈕。

回到Zigbee2MQTT裡，按下learn_ir_code的「ON」。

對UFO-U11按下紅外線遙控器的按鈕。

回到Zigbee2MQTT，此時learned_ir_code應該會出現一長串文字，這就是紅外線指令訊號。紅外線訊號的文字大概會像是這樣：

B4EgphE7AqEGgAPgCwFAG0ABQAdAA+APAUAbQAPgEwHgCx/gCxPgJwEDgSA7AuATR8AbwAdAAQJmAjvggAHAl0AHQANAAcAHwAFAD8ADQAFAC8ABQAtBA+AXAUAn4AcBQQdAA+AHAcAT4AcH4BsBQDNAa0AHwAFAC8ADQAFAC0ABQAfAA0AzQAFAD+ADCwdmAjsCOwI7Ag==

UFO-R11不會保存訊號內容，所以這個紅外線訊號，我是另外用Google Sheet表格來記錄。這個紅外線訊號會在後面發送的時候用到，請好好記下來吧。如果要學習其他訊號，請依樣畫葫蘆地取得紅外線遙控器上面每個按鈕的指令訊號。

發送紅外線指令訊號 / Send infrared command signal

相較於學習指令的容易理解，UFO-R11要發送指令就困難得多。從原理來看，我們要在UFO-R11的ir_code_to_send欄位裡填上紅外線訊號，這樣就能讓它發送訊號。但如果我們要在Home Assistant裡面操作的話，因為紅外線訊號的長度超過了Home Assistant的限制，所以我們得用MQTT發佈的方式將紅外線訊號設定到ir_code_to_send。

腳本內容的YAML如下：

action: mqtt.publish
metadata: {}
data:
  evaluate_payload: false
  qos: "2"
  retain: false
  topic: zigbee2mqtt/紅外線遙控器 電池 Zigbee UFO-R11 {Drosera heliamphora}/set
  payload: >-
    {"ir_code_to_send":
    "B8Ug6BEuArUGgANAAQJmAi7gAgEBZgJAG0ABQAdAA8ABAmYCLuAAAUAXwAPAAeAHH4APgAXAK0AHwAGAGQEuAsAH4CMBA8UgLgJAAeADT8ALQE/AC8AHwAHgAw9AJ+ABAeATDeAFAeALKUAT4CMDQIdAA8AzQAtAA8APQAdAD+AHA8AXQAdBA0AHQANAJ0AHQAFAB8ADwBfAD+AvB0AB4Bc74CtrwDNAB0AD4ARjAgIuAg=="}

其中紅字的「紅外線遙控器電池 Zigbee UFO-R11 {Drosera heliamphora}」是UFO-R11在Home Assistant的名稱，不是Entity ID。而藍字的部分就是紅外線訊號。

這個腳本就能讓紅外線訊號設定到UFO-R11的ir_code_to_send欄位，然後UFO-R11就會發送紅外線訊號。接著UFO-R11會自動清空ir_code_to_send，並等待下一個要發送的訊號，因此我們不需要手動重置ir_code_to_send，不用擔心UFO-R11會重複發送訊號。

值得注意的是，在UFO-R11設定ir_code_to_send、實際發送、清空ir_code_to_send的整個動作大概要3秒鐘。因此我們在Home Assistant發送紅外線訊號的時候，如果要發送多個紅外線指令，指令之間必須加上「delay」3秒以上的設定。這樣才能確保UFO-R11確實發送每一條紅外線指令。

結語 / Conclusion

在使用Home Assistant的這段經驗中，我用過了非常多種「萬能遙控器」。奇怪的是，每種萬能遙控器的學習指令與發送指令的方式都大不相同。本篇介紹的Moes UFO-R11要用z2m學習指令、用MQTT發佈來發送指令；Broadlink RM4 Pro要用Home Assistant的Learn Command學習指令、用Send Command發送指令；塗鴉系列的萬能遙控器則是在塗鴉自己的APP裡面學習指令，然後用「場景」來發送指令。目前看來，塗鴉的邏輯最容易理解，也非常好操作。但一定要用WIFI跟遠端伺服器連線才能運作的這點，還是讓我決定逐步替換塗鴉的WIFI設備。

雖然UFO-R11的學習跟發送都有點麻煩，但設定好之後，運作起來倒是意外地穩定。即時稍微被物品遮擋，紅外線訊號也能順利發送給冷氣。最後就是不知道這2顆AAA電池可以使用多久就是了。沒關係，兵來將擋、水來土掩，到時候冷氣開不起來我就知道了。

那這篇關於Moes UFO-R11跟Home Assistant的整合就介紹到這裡了。文章的最後要來問大家的是，你會想用萬能遙控器跟智慧家居整合嗎？

1. 會：回家自動開冷氣、離家自動關冷氣，幸福感UPUP。
2. 不會：這麼懶幹嘛，不過就是按個按鈕而已啊。
3. 再想想：如果遙控器沒電了怎麼辦？ (A：就...換電池而已)
4. 好恐怖：這樣駭客不就可以遠端操控我們家的冷氣嗎？太危險了！
5. 其他：歡迎在下面留言，分享你的看法吧！

雜談：MacBook好像不是只有一種 / TALK: MacBook Seems Not to Be the Only One

2025-07-11T12:00:00.007+08:00

最近拿到了一台別人不要的MacBook Air，這是2015年出產的版本。但沒想到MacBook Air的種類比我想像中的還要複雜許多。這個種類不只是指筆電的型號，還有它的週邊們。

2015年的MacBook Air / 2015 MacBook Air

拿到MacBook Air的第一件令我困擾的事情是：我沒有充電的裝置。它似乎是因為沒有電的關係，連開機都無法啟動。

https://support.apple.com/zh-tw/109509

印象中，MacBook系列的充電器可都不便宜。而且這臺並不像是如今的MacBook已經採用了USB Type-C接頭來充電，而是使用著早期的磁吸充電的形式。

我朋友聽了我的苦惱，拍拍胸脯跟我說：「沒問題，我家有之前MacBook Pro的充電線，借你。」過幾天我興高采烈地拿著朋友借我的接頭，然後我才意識到，原來MacBook的磁吸接頭有不同的規格。

https://support.apple.com/zh-tw/109509

首先，這是2012年到2017年的MacBook Air充電線，規格是MagSafe 2。

https://support.apple.com/zh-tw/109509

而這個是2011年以前MacBook Air使用的L型連接器充電線。

https://support.apple.com/zh-tw/109509

然後這是2006年到2009年MacBook Pro 15"跟17"使用的附「T」型連接器...等等，這跟前面的MagSafe 2看起來有什麼不同？難道只是一個是銀色跟白色的差異嗎？

當然不是，雖然照片上看不出來，但實際上兩者的規格並不相同，連插都插不進去。

後來我決定直接去買一個USB Type-C轉到MacBook磁吸充電頭的轉接器。為了確認這件事情，還跟店家來回問了好多回，最後才確認了要買MagSafe2的規格。真是感謝店家的耐心溝通。

最後花了149買到這個轉接頭，而且的確能夠正常使用。這樣我就可以拿USB Type-C的充電線，用PD來給MacBook Air充電了。

毀損的硬碟 / Damaged Hard Drive

順利開機之後迎接我們的畫面是...一個標示著「?」的資料夾不斷的閃爍。

「這一看就知道是硬碟或作業系統壞掉了。」Mac大師我朋友這樣說。

我們嘗試讓它連上網路並修復看看，結果是連硬碟本身都已經找不到了。看來這的確只能說是硬碟壞掉了吧。

我記得當年我拿過2017的MacBook Air，裡面的硬碟已經使用的是SSD。剛好手邊也有一條沒有用到的NVMe SSD，不知道能不能直接拿來用呢？這樣的話我是不是只要花不到百元買個MacBook Air拆機工具就可以了？

https://www.mobile01.com/topicdetail.php?f=481&t=5572538

不過查了一下，雖然都是使用SSD，但是需要轉接卡才能運作。而且2016之後有些版本的MacBook Air是焊在主機板上，不能替換。

想了想，成本好像太高了。而且說真的我也沒有使用MacOS的動機，好像不需要為它付出這麼多心力。

記憶卡的規格 / Memory Card Specifications

比起MacOS，我更寧願用我現在用的很順的Kubuntu。於是我找了個Kubuntu 22.04 LiveUSB，把作業系統安裝在記憶卡上，然後確實能用記憶卡來啟動Kubuntu。

只是這個由MicroSD轉接成SD的記憶卡插著總是會突出一大截。這可能不太容易攜帶或塞進包包，不小心折斷了怎麼辦。

印象中有人為了MacBook推出了短板的MicroSD轉接卡，號稱插入後可以直接貼合筆電本身。不過這勾起了我當年使用MacBook Air的回憶。我記得那時候也是買了類似的卡片，然後實際上根本就無法貼合，轉接卡還是在外面露出一節，搬動的時候特別容易卡到。

後來我也跟店家確認型號，所有的店家也都跟我說並不適用在MacBook Air 2015的這臺筆電上。我嘆了口氣，只好放棄用記憶卡開機的做法。

後來我是拿SanDisk的USB隨身碟開機。SanDisk的Ultra Fit隨身碟刻意做成非常短的形式，即使插在主機上也不太醒目或卡手。缺點是也很難拔出來，而且很容易忘記帶走。反正充電轉換頭本來就會突出一節，那多一個隨身碟也不會差太多，我就這樣將就著用吧。

鍵盤 / Keyboard

用隨身碟開啟Kubuntu，確實也可以用MacBook Air的硬體來開機。這樣我就可以看到亮麗的螢幕、漂亮的機身、寬廣的觸控板，還有……我一直無法適應的鍵盤。

Mac OS的鍵盤左下角是用fn、control、option、command來構成。但是這些按鍵在Linux的對應中，control是對應到control鍵沒錯，而option對應到alt，然後command對應的是Windows鍵(Linux裡面稱它為Meta鍵)。而fn是用來搭配最上面一排功能鍵來啟用F1到F12。

https://www.duotin.com/en/61440.html

作為時常要使用Ctrl的人來說，我真的很難接受Control鍵不在左下角的鍵盤設計。有段時間鍵盤十分流行這種fn在左下角的設計，甚至有些Windows筆電的鍵盤也採用這種設計，讓使用者被迫接受fn在左下角的操作，當時真的是讓我痛苦萬分。

https://www.lenovo.com/us/en/p/laptops/thinkpad/thinkpadl/thinkpad-l13-yoga-gen-2/22tpl13l3y2?orgRef=https%253A%252F%252Fwww.google.com%252F

我現在在用的ThinkPad L13 Yoga就是fn在左下角的設計。不過ThinkPad可以在BIOS裡面調換fn跟ctrl的位置，因此現在左下角的fn實際上是作為ctrl使用，我才勉強能夠接受。

https://www.momoshop.com.tw/goods/GoodsDetail.jsp?i_code=13628590&Area=search&mdiv=403&oid=1_1&cid=index&kw=ideapad

不過我最近去電腦商店觀察筆電的時候，赫然發現現在很多筆電左下角都使用了Ctrl。這包括了ASUS、Acer、甚至是聯想的IdeaPad都是如此。不知不覺鍵盤的設計又輪迴了一圈了，真是微妙。之後微軟還要大家在鍵盤上加上Coplit鍵，可能到時候鍵盤又會變了個樣吧。

結語 / Conclusion

話說回來，儘管我在MacBook Air上跑了Kubuntu 22.04，但因為隨身碟的速度實在是太慢了。只要電腦處理檔案的寫入跟讀取操作，整個畫面就會直接結凍、無法操作，直到檔案操作完成為主。簡單來說就是無法正常使用。

目前我也暫時想不到到底可以拿它來作什麼好。畢竟是2015年的電腦，也不太能期待它的效能。

就先這樣吧。

在Docker的Nextcloud用腳本新增外部網頁連結 / Adding External Site Links Using Scripts in Nextcloud on Docker

2025-07-07T12:00:00.006+08:00

客製化Nextcloud的下一步，我們能不能將外部網頁嵌入到Nextcloud的應用程式裡面呢？答案是使用外部網頁(External sites)擴充功能。我們可以進一步在Docker的Hook Folders中的post-installation資料夾中加入腳本，讓Nextcloud安裝完成後，自動開啟外部網頁擴充功能，並且將指定的網址加入到Nextcloud系統中。

The next step in customizing Nextcloud: can we embed external web pages into Nextcloud applications? The answer is yes, using the External sites app. We can further automate this process by adding a script to the post-installation folder within the Docker Hook Folders. This script will enable the External sites app and add specific URLs to the Nextcloud system after Nextcloud installation is complete.

Nextcloud的外部網站應用程式 / External Sites in Nextcloud

https://apps.nextcloud.com/apps/external

Nextcloud 的外部網站應用程式（External Sites App）是一個簡潔卻功能強大的工具，讓管理者可以輕鬆地將外部網站連結整合到 Nextcloud 的網路介面中。使用者只需點擊對應的圖示，即可在 Nextcloud 框架內直接瀏覽外部網站，帶來如同使用 Nextcloud 內建服務般的無縫體驗。這對於需要經常參考特定外部資源的團隊或個人來說，無疑提升了工作效率，也簡化了操作流程。例如，公司可以將內部網路（Intranet）、客戶關係管理系統（CRM）或其他常用線上工具的連結新增到 Nextcloud，讓員工可以集中管理和快速取用這些資源。

這個應用程式設定起來非常簡單，管理者只需提供外部網站的網址（URL）和名稱即可。系統會自動產生對應的圖示，並將其顯示在 Nextcloud 的應用程式選單中。更進一步地，管理者還可以針對不同的語言、裝置類型或使用者群組設定不同的外部網站連結，實現更精細的客製化管理。舉例來說，可以針對不同部門設定專屬的外部資源連結，或是根據使用者使用的裝置（例如電腦或手機）顯示不同的網站版本。

除了基本功能外，外部網站應用程式還支援透過 OCS（OwnCloud/Nextcloud Service）API 進行互動。這表示開發者或系統管理者可以透過程式化的方式管理這些連結，例如自動新增、修改或刪除連結，進而實現自動化管理和與其他系統的整合。而我們這篇的做法，就是利用了Nextcloud內建的API，用指令來新增外部網站的網址。

安裝後新增網站的腳本 / Add External Sites in Post-Installation Script

這篇的做法繼承自「讓Docker架設的Nextcloud預設關閉或開啟應用程式」的操作，我們一樣使用Docker的鉤子資料夾(hook folders)裡面的/docker-entrypoint-hooks.d/post-installation，將客製化的腳本放在裡面。這樣Nextcluod在安裝完成之後，就會自動執行這個資料夾裡面的腳本。

我將啟用外部網站應用程式與新增網站的腳本寫成add_external_sites.sh腳本。檔案內容很簡單，只有兩行指令：

#!/bin/bash

/var/www/html/occ app:enable external
/var/www/html/occ config:app:set external sites --value='{"1":{"id":1,"name":"My Blog","url":"https://blog.pulipuli.info","icon":"icon-external","lang":"","redirect":false}}'

我們用「/var/www/html/occ app:enable external」開啟Nextcloud的外部網站應用程式。然後用後面的指令加入外部網站，其中值得注意的參數是：

id：會影響Nextcloud開啟外部網站的網址，只能使用數字。如果設定為1，那麼你就可以用「http://localhost:8080/apps/external/1/」開啟該外部網站。
name：顯示在按鈕上的名稱。
url：外部網站的實際網址。
icon：外部網站的圖示。你可以在「List of available icons」裡面找到其他圖示設定。

如此一來，安裝好Nextcloud之後，腳本就會自動將外部網站的網址加入到Nextcloud中。我們就能在Nextcloud直接開啟這個外部網址了。

結語 / Conclusion

https://github.com/nextcloud/external/issues/6

乍看之下add_external_sties.sh只有兩行指令，但實際上我花了很多時間才找到正確的設定方式。一開始我本來是想用ChatGPT跟Gemini給我建議，但AI給的建議並不正確。而後我在很多網頁上找到各種可能的指令形式，直到最後找到rbax的建議，才釐清正確的指令形式。

可能是因為Nextcloud外部網站是一個很少人在使用的功能吧，找起來真是意外地棘手啊。希望未來有類似需求的開發者可以參考一下我這篇的做法。

這篇關於在Nextcloud用腳本新增外部網站的做法就到此為止了。文章最後的問題是：你覺得雲端硬碟需要這種整合外部網站的功能嗎？

1. 需要：把相關網站都擺到Nextcloud，使用上應該會更為便利。
2. 不需要：Nextcloud就做好雲端硬碟即可，不需要搞這些雜七雜八的玩意兒。
3. 應該讓使用者自行判斷：(其實本來就可以讓使用者自己調整外部網站啦)
4. 其他：歡迎在下面留言，分享你的看法吧！

雜談：3M牙線停售了 / TALK: 3M Dental Floss Discontinued

2025-07-04T12:00:00.001+08:00

之前我很常用的3M牙線，最近想要補充庫存的時候，我才發現它因為生產過程造成PFAS而停售了。

3M細滑微孔結牙線 / 3M Stylish Dispenser

https://disp.cc/ptt/Gossiping/1ckCCX6y

之前我用3M的牙線已經用了好一陣子。這是我用過的牙線中，少數不會分叉，而且清理效率也神奇地比其他牙線高的好用牙線。

但是最近要購買補充庫存品的時候，發現到處都已經停產，再也買不到了。

3M停售PFAS產品 / 3M to Halt Production of PFAS Products

https://disp.cc/ptt/Gossiping/1ckCCX6y

根據yoshika的說法，3M因為生產PFAS造成環境汙染，因此停售了各種PFAS產品，而這款牙線也因此再也不生產。

https://topic.moenv.gov.tw/pops/cp-104-10935-53d66-2.html

PFAS是一種永久性的化學物質，它廣泛應用在各種商品上，但它因為需要很長的時間才能被分解，容易擴散到土壤、水質並影響生物，並不符合現在環保法規的要求。因此現在全球逐漸降低PFAS的使用。

https://youtu.be/9dE2hcUi7cU

YouTuber阿淇博士 Dr. Achi在頻道裡常常宣導儘量避免使用PFAS的產品，沒想到我自己使用的牙線竟然也有PFAS，真的是無所不在。

https://lennychen.com/%E4%BD%A0%E6%88%96%E4%BD%A0%E5%AD%A9%E5%AD%90%E7%94%A8%E7%9A%84%E7%89%99%E7%B7%9A%E6%98%AF-ptfe-%E5%81%9A%E7%9A%84%E5%97%8E%EF%BC%9F/

稍微調查一下，赫然發現網路上很多人推薦的Oral-B Glide牙線，竟然也可能含有PFAS化學物質。

https://www.facebook.com/MedPartnerTW/posts/pfbid02jZD5GxPVknuWXdk1XiutFeWiGscEFQHhVmS5uZSB5ivdtcUx1GdpDXwb91XfX7avl?comment_id=1952482621529795&__cft__[0]=AZVfk9riqqnl90rXKtTamvbRaEq-RdGvbGaYpAhU2cM-iibiztGQ3hqowafEEDHsGeF5ZmtWp1sR8lK6PrC28f-dI9-eafZFzeEfjmZKCq-Wngrpd2PeBFX-gtzqyPiMAaJ_ixO5C4lO7CqhtMCz6MzqhSmHozC3L9EKLjkEo3NTyA&__tn__=R]-R

不過Oral-B也聲明過它們的牙線並不含PFAS，實際上檢測並沒有測到PFAS。

https://renouvo.net/zh/products-safety-quality/what-products-contain-pfas/

再深入調查一下，生活中竟然各種東西都包含了PFAS。這些包括個人護理用品、化妝品、電子產品、日常用品、戶外用品、房屋與傢俱、廚房用品、服飾、清潔劑、車輛、醫療用品、食品等等。

https://shopee.tw/%EF%BC%88%E6%AD%A3%E5%93%81%EF%BC%89-%E7%8F%BE%E8%B2%A8%F0%9F%8C%B8-USDA%E8%AA%8D%E8%AD%89RADIUS%E7%B6%A0%E8%8C%B6%E8%8C%89%E8%8E%89%E7%89%99%E7%B7%9A%E4%B8%8D%E5%90%AB-PFAS-%E8%B5%A4%E8%98%9A%E7%B3%96%E9%86%87-%E8%96%84%E8%8D%B7-%E9%A6%99%E8%8D%89%E8%96%84%E8%8D%B7-%E5%8E%9F%E5%91%B3%E5%90%AB%E8%A0%B6%E7%B5%B2%E9%85%8D%E6%96%B9-i.4080726.11343715308

網路上可以找得到不含PFAS的牙線，但是那個價格可就真的不便宜了。

小結 / In Closing

http://web.tccf.org.tw/lib/addon.php?act=post&id=4418

目前看下來，3M停售了含有PFAS的牙線，而Oral-B等幾家廠商宣稱自己的牙線不含PFAS。到底要抵制PFAS到什麼程度，似乎挺令人糾結的。但整體看來，牙線的PFAS似乎沒有傷害人體的直接證據，牙醫還是會建議大家使用牙線，然後盡可能挑選不含PFAS的牙線即可。

Nextcloud客製化網頁：插入外部JavaScript腳本 / Nextcloud Customized Webpage: Inserting External JavaScript Scripts

2025-06-30T12:00:00.008+08:00

要大幅度修改Nextcloud的網頁的話，建立主題(theme)可能是最常見的建議。但如果我們是要在Nextcloud的網頁裡面插入外部JavaScript腳本的話，這手續可就麻煩得多了。讓我們應用調整Docker的Nextcloud的技巧，在Nextcloud安裝完後，自動佈署修改後的程式碼吧。

If you want to drastically modify the Nextcloud web interface, creating a theme is probably the most common suggestion. However, if you want to insert external JavaScript scripts into the Nextcloud web pages, the procedure becomes much more complicated. Let's apply the techniques of customizing a Dockerized Nextcloud instance to automatically deploy modified code after Nextcloud is installed.

Nextcloud程式碼的位置 / Location of Nextcloud Code

https://hub.docker.com/_/nextcloud/

在Nextcloud的Docker版本裡面，Nextcloud的程式碼被擺在「 /var/www/html 」裡面。而影響Nextcloud顯示外觀的程式碼則擺在更深一層的「 /var/www/html/core/templates/ 」裡面。

https://www.schillmania.com/projects/snowstorm/

我們要客製化什麼功能呢？這邊舉的例子是scottschiller發佈的「Snowstorm」。它的程式碼可以讓網頁開始下雪。一般的做法是在網頁裡面插入以下程式碼即可：

<script src="https://cdnjs.cloudflare.com/ajax/libs/Snowstorm/20131208/snowstorm-min.js"></script>

但是要在Docker的Nextcloud裡面就沒有這麼簡單了。首先，在Nextcloud安裝之前，其實「/var/www/html」並沒有任何檔案跟資料夾。如果我們用Docker的volume直接掛載，這會與Nextcloud內部的權限相互衝突，安裝會無法順利進行。解決方法是必須在安裝之後再複製修改後的腳本。

另一個問題是Nextcloud在前端網頁執行的<script>需要加上「nonce」屬性。在 HTML 和 JavaScript 中，nonce (全稱為「number used once」，即「一次性數字」)是一種安全機制，主要用於 內容安全政策 (CSP，Content Security Policy)，以防止跨站腳本攻擊（XSS，Cross-Site Scripting）。為了要讓，<script>能在Nextcloud裡面執行，我們需要把原始的<script>配合Nextcloud的寫法，修改成以下的樣子：

<script
  nonce="<?php p($_['cspNonce']); ?>"
  src="https://cdnjs.cloudflare.com/ajax/libs/Snowstorm/20131208/snowstorm-min.js"
></script>

其中「<?php p($_['cspNonce']); ?>」便是由Nextcloud自動產生的nonce。每次讀取網頁都會不一樣，但只有擁有同樣nonce的JavaScript腳本才能順利執行。

在Docker版本Nextcloud裡面客製化程式碼 / Customizing Code Within a Dockerized Nextcloud Instance

https://github.com/pulipulichen/docker-Nextcloud-demo-2025

在瞭解問題之後，我們便能開始嘗試修改Docker版本Nextcloud的程式碼。為了方便說明，我將程式碼擺放到「docker-Nextcloud-demo-2025」GitHub保存庫，供大家參考。

關鍵的修改點有三個：

1. 準備要修改的程式碼 / Preparing to Modify the Code

如果我們要讓客製化的JavaScript在登入之後才會執行，那麼我們要修改的是「 /var/www/html/core/templates/layout.user.php」。layout.user.php的原始碼可以在nextcloud/server的GitHub保存庫找到。

https://github.com/pulipulichen/docker-Nextcloud-demo-2025/blob/d7005e4844bd48eae56bfa99178c6ce74f234e69/html/core/templates/layout.user.php#L96

我們要作的事情是在layout.user.php加上需要客製化的程式碼。我把它加在</body>前面。完整程式碼可以看我在GitHub上的layout.user.php。

2. 在docker-compose.yml掛載客製化程式碼 / Mounting Custom Code in Docker-Compose.yml

接下來我們要在docker-compose.yml，把客製化程式碼的資料夾用volumnes掛載。我把客製化程式碼放在「html」資料夾底下，而Docker裡面我則是掛載到「/html」路徑。完整配置可以看我在GitHub上的docker-compose.yml。

3. Nextcloud安裝完成後複製客製化程式碼 / Copy Customized Code After Installing Nextcloud

接著我們使用「讓Docker架設的Nextcloud預設關閉或開啟應用程式」這篇的技巧，在「post-installation」裡面加上「copy_html.sh」，讓它出現在Nextcloud容器裡面的「/docker-entrypoint-hooks.d/post-installation」資料夾底下，這樣Nextcloud在初次安裝完成後便會執行裡面的程式碼。

GitHub保存庫裡面可以看到copy_html.sh的完整內容，但其實主要程式碼只有兩行：

#!/bin/bash

cp -rf /html/* /var/www/html/

這個意思是在Nextcloud安裝完成後，將掛載到「/html」的客製化程式碼，全部複製到「/var/www/html/」裡面，並且直接覆蓋。

這樣我們就設定完成了。

成果 / Outcomes

如果你之前已經安裝過Nextcloud，此時我們要先移除掉Docker建立的持久性檔案集 (volume)，指令如下：

docker compose down -v

接著再用啟動Nextcloud：

docker compose up

登入Nextcloud。登入的帳號密碼已經在docker-compose.yml設定了，我這裡的預設是「admin」跟「password」。

登入之後，你可以注意到Nextcloud的介面有了雪花紛飛的特效。這樣就完成囉。

結語 / Conclusion

由於Docker的設計方式，使得我們不容易修改安裝後的Nextcloud。現在借住鉤子資料夾post-installation的設計，我們得以在Nextcloud安裝完後還能修改程式碼。這篇也連帶解決了CSP安全性問題中較為常見的nonce機制。

如果你在Nextcloud安裝完成後還想要修改程式碼的話，那要如何處理呢？很簡單，鉤子資料夾還有「/docker-entrypoint-hooks.d/before-starting」這項設定，可以讓你在啟動Nextcloud之前執行。那我們就可以這篇的做法，在Nextcloud執行之前複製客製化程式碼即可。

有人可能會問，「在Nextcloud容器裡面複製到 /var/www/html 的檔案，會保存在主機的那個位置呢？」我們的設定是保存在「nextcloud:」volume裡面，而這是由Docker管理的內部保存位置。Linux裡是保存在「/var/lib/docker/」底下，但它並不是由我們在容器裡面看到的形式保存，而是用特殊的雜湊資料結構陳列。關於Docker Volume的概念可以看看flynncanfly所寫的「Day-7 解析 Docker Volume」。

Docker的概念跟傳統程式教學那種修改程式碼的做法並不相同，但越熟悉Docker，就會越感嘆這種自動化微服務設計的精妙。一起學習吧。

這篇關於在Docker版本Nextcloud加入客製化程式碼的介紹就到此為止了。文章最後要來問大家的是，要客製化Nextcloud的話，你會怎麽作呢？

1. 改PHP我最行，學校都教PHP。
2. Nextcloud不是可以改css跟logo之類的外觀嗎？
3. 還是老老實實地開發Nextcloud的應用程式吧。
4. Docker的環境變數就有很多可以調整的設定了吧？需要這麼複雜嗎？
5. 其它：歡迎在下面留言，分享你的看法吧！

雜談：修正「布丁布丁吃什麼？」部分功能 / TALK: “Pulipuli’s Blog” Feature Improvements

2025-06-27T12:00:00.007+08:00

每隔一段時間就把累積的問題逐步修正，這次要來修正的是下載跟目錄的問題。

下載文章 / Article Download

如果登入帳號是「布丁布丁吃什麼？」的管理者的話，文章的開頭會顯示相關的管理功能，包括編輯、複製HTML程式碼、下載、文章內容的統計功能等等。

其中下載功能是讓整份文章變成單純的HTML跟完整圖片所壓縮而成的壓縮檔案。壓縮檔裡面的HTML檔案只保留了部落格文章的內文跟圖片連結，不包含「布丁布丁吃什麼？」的其他元素。

這不僅僅只是用於備份文章時可以節省一些空間，更重要的是，我可以將壓縮檔匯入到Blogger Editor裡面，方便編輯文章的內容。

原本功能的問題是備份文章的時候圖片檔案名稱過長、圖片檔案未加上圖片相關的副檔名、備份抓取的文章內容包含了不相干的元素等等，現在總算修正這些問題了。

文章目次 / Table of Contents

「布丁布丁吃什麼？」文章的目次是由程式碼分析文章內容動態產生，但這個做法造成了許多問題。之前就有講過目次的錨點造成CSS文章排版錯誤，這次的問題是文章目次快取帶來的錯誤。

為了避免每次都要重新產生目次，瀏覽器只要產生過該文章的目次後，就會把它保存到localStorage作為快取。下次開啟文章的時候就會直接用快取的程式碼來顯示目次。

但如果該文章原本就沒有目次的話，這個做法會造成文章排版的錯誤。這個問題會發生在有些沒有標題的文章裡面，並造成文章的水平線消失。

現在已經修正這個問題了。

小結 / In Closing

是說現在Google搜尋引擎的排序好像逐漸把社群媒體的重要性提高了。在Google上搜尋我自己的文章時，大多時候出現的都是發佈在Facebook或Instagram的連結。社群媒體上的內容其實都是部落格的引流工具而已，怎麽喧賓奪主了呢？

我也不確定這個問題該怎麽處理好，這也可能代表著部落格的沒落吧，真是無奈啊。

讓Docker架設的Nextcloud預設關閉或開啟應用程式 / Enabling or Disabling Apps by Default in a Dockerized Nextcloud Instance

2025-06-23T12:00:00.005+08:00

既然談到用Docker架設Nextcloud，那我們就要活用Docker的架構，讓Nextcloud不僅僅是「開箱可用」，而且還是「自訂後」的可用。我們可以客製化的指令放在「/docker-entrypoint-hooks.d/post-installation」資料夾內，這樣就可以讓Nextcloud初次安裝完成後，自動進行我們要的設定。

Since we're talking about setting up Nextcloud with Docker, let's leverage Docker's architecture to make Nextcloud not just "usable out-of-the-box," but usable after customization. We can place custom commands in the /docker-entrypoint-hooks.d/post-installation directory, allowing Nextcloud to automatically perform our desired configurations after the initial installation completes.

Docker Nextcloud的自動配置 / Automated Configuration in Docker Nextcloud

https://hub.docker.com/_/nextcloud

在Nextcloud的Docker映像檔裡，有提到Nextcloud提供了五個自動配置的鉤子資料夾(hook folders)。只要我們將可以執行的腳本(.sh)放在資料夾內，Nextcloud就會在佈署過程中的特定階段嘗試去執行這些腳本。

這些資料夾各別是：

/docker-entrypoint-hooks.d/pre-installation：在 Nextcloud 安裝/初始化之前執行
/docker-entrypoint-hooks.d/post-installation：在 Nextcloud 安裝/初始化之後執行
/docker-entrypoint-hooks.d/pre-upgrade：在 Nextcloud 升級之前執行
/docker-entrypoint-hooks.d/post-upgrade：在 Nextcloud 升級之後執行
/docker-entrypoint-hooks.d/before-starting：在 Nextcloud 啟動之前執行

如果我們要讓Nextcloud在安裝完後進行客製化，那麼將腳本擺在「/docker-entrypoint-hooks.d/post-installation」裡，讓Nextcloud在初次安裝完成後自動執行，應該會是最合適的選擇。

我們可以在docker-compose.yml的volumes將腳本掛載上去，這樣Docker啟動Nextcloud的時候，就會嘗試去讀取腳本的內容。

自訂應用程式 / Custom Applications

https://docs.nextcloud.com/server/25/user_manual/en/files/version_control.html

那麼我們要讓Nextcloud使用什麼客製化腳本呢？舉例來說，Nextcloud雖然有許多強大的應用程式，但大多時候都只是拖慢速度的元件，不如關閉。舉例來說，如果沒有這方面的需求，我特別建議關閉「files_trashbin」跟「files_versions」應用程式，不然這兩個應用程式會不斷記錄刪除和修改的檔案，佔用許多額外的檔案空間。

https://docs.nextcloud.com/server/latest/admin_manual/configuration_files/external_storage_configuration_gui.html

另一方面，我個人還蠻常使用「files_external」應用程式，這可以讓我們掛載外部的雲端硬碟，讓Nextcloud作為橋接的中間站，非常好用。

因此，我們可以在post-installation裡面新增腳本「app-initialize.sh」，內容如下：

#!/bin/bash


/var/www/html/occ app:enable files_external

/var/www/html/occ app:disable files_trashbin
/var/www/html/occ app:disable files_versions
/var/www/html/occ app:disable activity
/var/www/html/occ app:disable app_api
/var/www/html/occ app:disable bruteforcesettings
/var/www/html/occ app:disable systemtags
/var/www/html/occ app:disable comments
/var/www/html/occ app:disable contactsinteraction
/var/www/html/occ app:disable dashboard
/var/www/html/occ app:disable files_reminders
/var/www/html/occ app:disable federation
/var/www/html/occ app:disable files_downloadlimit
/var/www/html/occ app:disable firstrunwizard
/var/www/html/occ app:disable logreader
/var/www/html/occ app:disable serverinfo
/var/www/html/occ app:disable webhook_listeners
/var/www/html/occ app:disable notifications
/var/www/html/occ app:disable password_policy
/var/www/html/occ app:disable photos
/var/www/html/occ app:disable privacy
/var/www/html/occ app:disable recommendations
/var/www/html/occ app:disable related_resources
/var/www/html/occ app:disable sharebymail
/var/www/html/occ app:disable support
/var/www/html/occ app:disable circles
/var/www/html/occ app:disable updatenotification
/var/www/html/occ app:disable survey_client
/var/www/html/occ app:disable user_status
/var/www/html/occ app:disable weather_status
/var/www/html/occ app:disable files_sharing
/var/www/html/occ app:disable nextcloud_announcements

如此一來，建立好的Nextcloud就會是相當單純的環境。不需要用到的應用程式都會被關閉了。

結語 / Conclusion

這篇展示了如何使用「post-installation」來開啟與關閉Nextcloud應用程式的做法。實際上，我還會在「before-starting」資料夾裡面添增腳本，讓每次啟動Nextcloud的時候都執行特定指令。透過這些「鉤子資料夾」(hook folders)的搭配，我們便能很大程度地調整Nextcloud的功能。

https://docs.docker.com/docker-hub/repos/manage/builds/advanced/#custom-build-phase-hooks

附帶一提，「鉤子資料夾」這並不是Nextcloud獨有設計，而是大部分Docker映像檔都會遵循的一種開發架構。如果你也想要客製化Docker映像檔所建立的容器，不妨研究看看這些「鉤子資料夾」的設定吧。

那這篇關於客製化Docker架設的Nextcloud就介紹到這裡了。文章的最後要來問大家的是，你覺得雲端硬碟應該要有那些功能呢？

1. 垃圾桶：不小心刪除檔案，還要可以救得回來才行。
2. 版本控制：有時候不小心改錯內容，這時候就可以找回之前的版本。
3. 檔案分享：能夠有個網址讓其他人下載，這樣是最方便的了。
4. 其他：歡迎在下面留言，分享你的看法吧！

雜談：有電梯與沒有電梯的大樓 / Talk: Buildings With and Without Elevators

2025-06-20T12:00:00.000+08:00

到底是走很近就能抵達，但沒有電梯的大樓好；還是必須走到山上，但是有電梯的大樓好呢？

很近的大樓 / The Building, But Very Close

我之前工作的兩個地方都在山上，但兩個工作場所截然不同。

我之前工作的地方有著微妙的好處和壞處。壞處是樓梯間貼著募款蓋電梯的海報，從我看到它出現在牆壁上到現在，電梯還是沒有蓋出來。但它的好處也十分明顯：近。如果能順利找到機車的車位，那大概走路3分鐘就能夠抵達大樓樓下。連帶的好處就是附近各種吃飯的地方都很方便，全部都是下個樓、走一下就可以輕鬆抵達的距離。不過……回來時還是要爬樓梯。

有電梯的大樓 / Building, But With an Elevator

而我更之前工作的另一個地方是真的「在山上」。這個山的程度是，大概有一半的學生不會認知到把位置其實還是在校園的範圍內，而且早期的Google Map還真的把它畫出到校園外的程度。即使騎車停在停車場，要抵達工作場所的時候還是需要走很遠的路，而大部分的人會選擇搭公車。至於抵達之後，工作場所為了無障礙設置了電梯，能夠一口氣坐到頂樓去上班。是說當電梯蓋好的時候，它還蠻常壞的。但在不知不覺間它好像終於修好了，之後就很少看到它當機的樣子，真是可喜可賀。

嗯？你說開車的話，就不用走這麼遠了啊。嗯……首先，要有車……

儘管如此，我其實還是蠻喜歡走上山的感覺。離開的時候在橋上看到了耶穌光，好美。

用Docker建構開箱可用的Nextcloud / Deploying a Ready-to-Use Nextcloud Instance with Docker

2025-06-16T12:00:00.007+08:00

Nextcloud是一個相當受歡迎的自架雲端硬碟應用程式。過往我都是用LXC的容器形式架設，這次我們要用Docker技術架設Nextcloud。要架設一個開箱可以用的Nextcloud其實還是有點複雜，我把相關參數整理成docker-compose.yml，希望對有需要的人有所幫助。

Nextcloud is a popular self-hosted cloud storage application. Previously, I used LXC containers for setup, but this time we'll use Docker. Setting up a ready-to-use Nextcloud instance can be somewhat complex. I've organized the relevant parameters into a docker-compose.yml file, hoping it will be helpful for those in need.

Nextcloud

https://nextcloud.com/

Nextcloud 是一款開放原始碼的自架雲端儲存服務軟體，讓使用者可以在自己的伺服器上建立類似 Dropbox、Google Drive 或 iCloud 的功能。它提供檔案同步與分享、線上辦公室套件 (Office Suite)、聯絡人與行事曆管理、以及更多豐富的應用程式 (Apps)。透過 Nextcloud，您可以掌控自己的資料，不用擔心隱私外洩，同時享有高度客製化的彈性，打造專屬的雲端空間。

Nextcloud 的介面設計簡潔直覺，容易上手。您可以透過網頁瀏覽器、桌面用戶端 (Desktop Client) 或行動應用程式 (Mobile App) 存取和管理您的檔案。它支援檔案版本控制，萬一誤刪或修改檔案，可以輕鬆還原到先前的版本。此外，Nextcloud 也提供強大的協作功能，讓您可以與團隊成員共享檔案、共同編輯文件，並透過內建的通訊工具進行討論，提升團隊合作效率。

Nextcloud的擴充功能 / Apps in Nextcloud

Nextcloud 除了基本功能外，還支援各式各樣的擴充應用程式，例如：即時通訊、視訊會議、心智圖工具等等。您可以根據自己的需求安裝不同的應用程式，打造更全面的個人或團隊工作平台。

https://www.youtube.com/watch?v=6_BPOZzvzZQ&t=138s

值得注意的是，最近Nextcloud也引入了本地端大型語言模型的應用，可以讓大型語言模型讀取存放在Nextcloud的檔案，並且據此進行文字生成、問答與輔助寫作等功能。可惜目前本地端的應用並沒有支持中文。

儘管如此，Nextcloud能夠讓人自行架設雲端平臺，而且還有電腦、手機等APP可供同步使用，其實已經是非常強大且受歡迎的應用程式了。

用Docker架設Nextcloud / Setting up Nextcloud with Docker

https://hub.docker.com/_/nextcloud

Nextcloud是以PHP建構的應用程式。以往我都是用Turnkey Linux Nextcloud架設，但Turnkey Linux的應用是LXC容器，比較不容易佈署。於是我就打算使用Docker來架設Nextcloud。

Nextcloud也有提供Docker映像檔，而且是Docker官方認證的應用程式。我們可以用最基本的指令來架設Nextcloud：

docker run -d -p 8080:80 nextcloud

然後我們就可以在本機端開啟網頁「http://localhost:8080」....怎麽出現錯誤訊息了？這是因為一開始Nextcloud要花一點時間佈署系統。大概要三分鐘。

等一段時間再重新讀取網頁「http://localhost:8080」，此時就能看到Nextcloud的初始設定畫面。這樣就可以開始探索Nextcloud了。

不過這個最簡單的設定，實際使用的時候效率不太好。Nextcloud比較推薦的形式是搭配資料庫一起使用，而我也希望能夠略過開啟建立帳號等確認環節，讓我一打開就能用Nextcloud。因此，我們需要用docker-compose.yml加入更多設定。

用docker-compose.yml佈署Nextcloud / Deploying Nextcloud with docker-compose.yml

你可以用以下的docker-compose.yml來建立Nextcloud：

version: "3.8"

services:
  nextcloud:
    image: nextcloud
    container_name: nextcloud
    depends_on:
      - nextclouddb
      - redis
    ports:
      - 8080:80
    volumes:
      - ./data:/var/www/html/data
      - nextcloud:/var/www/html/
    environment:
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud
      - MYSQL_PASSWORD=dbpassword
      - MYSQL_HOST=nextclouddb
      - REDIS_HOST=redis
      - NEXTCLOUD_ADMIN_USER=admin
      - NEXTCLOUD_ADMIN_PASSWORD=password

  nextclouddb:
    image: mariadb:11.6-ubi
    container_name: nextcloud-db
    command: --transaction-isolation=READ-COMMITTED --binlog-format=ROW
    volumes:
      - db:/var/lib/mysql
    environment:
      - MYSQL_RANDOM_ROOT_PASSWORD=true
      - MYSQL_PASSWORD=dbpassword
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud
      
  redis:
    image: redis:7.2.7-alpine3.21
    container_name: redis

volumes:
  nextcloud:
  db:

值得注意的是標示紅字的「admin」跟「password」是預設管理者的帳號跟密碼，您可以根據自己的需要進行修改。

然後在擺放docker-compose.yml的資料夾下，執行「docker compose up」。

等待大概5分鐘左右，Nextcloud會佈署好資料庫跟預設要設定的檔案。最後看到apache2啟動的消息，就表示可以連線了。第二次啟動Nextcloud就不需要這麼久的時間，大概5秒鐘就可以使用了。

請輸入「http://loclahost:8080」開啟Nextcloud。帳號跟密碼請使用上面docker-compose.yml的設定。

接下來你就可以自由使用Nextcloud了。

本機檔案 / Local Volume

我將Nextcloud擺放資料的資料夾掛載到跟docker-compose.yml同樣目錄底下的「data」資料夾。但它一開始創建的時候會被限制權限，請用「sudo chmod 777 -R data」來開啟它的權限。

在「data/admin/files/」底下，便能看到admin帳號的檔案。

但是要注意的是，我們在本機修改Nextcloud的檔案時，它不會直接反應到Nextcloud系統裡面。這必須要執行「occ files:scan」，Nextcloud才會掃描看看檔案有沒有變更，然後才會儲存到Nextcloud系統內。

因此，一般情況下都不建議不透過Nextcloud來修改檔案。

Nextcloud客戶端應用程式 / Nextcloud Client APP

https://nextcloud.com/install

要使用Nextcloud的話，比較正常的做法是用Nextcloud的客戶端來連線。Nextcloud為各個平臺都開發了對應的客戶端：

桌面環境：Windows 10以上 (64bit)、macOS 12以上、Linux Appimage (我現在就用這個)
行動裝置：Android、iOS

當然，你也可以直接使用Nextcloud的網頁來上傳、下載與修改檔案。Nextcloud網頁有著各種強大的應用程式，甚至可以讓你在網頁上對PDF檔案寫註解、標亮文字，非常好用呢。

結語 / Conclusion

我使用Nextcloud已經有好幾年的時間。之前使用Nextcloud的目的是同步Google Drive，克服rclone在網路不穩定時拖累系統的問題。但如果要跟Google Drive同步，那我們需要對系統有更多的調整，也需要定期執行檔案掃描，它才能正常運作。相關的細節我在「Nextcloud的安裝」跟「手動打造Google Drive同步工具：ownCloud與rclone的組合」都有記錄。

不過這次我的目標就不是架設長期使用的伺服器，而是要架設一個容易佈署、能夠跟其他系統整合的檔案管理工具。有陣子我使用的是「File Browser」，它架設很容易，但老實說它很難用，甚至要瀏覽照片都很不方便。結果，到頭來我還是回來研究Nextcloud了。

就讓我們看看Nextcloud可以作什麼調整吧。

那這篇關於用Docker自架Nextcloud的介紹就到此為止了。文章的最後要來問大家的是，你會想要自架雲端硬碟嗎？

1. 自己的資料自己管，好像不錯喔。
2. 太複雜了，我花錢買iCloud或Google One就好了吧。
3. 可以動手修改的雲端硬碟，聽起來很有發展潛力。
4. 有需要雲端硬碟嗎？我都把「小沈 1500」記在隨身碟裡面。
5. 其他：歡迎在下面留言，分享你的看法吧！

雜談：燈泡不時熄滅，好像還是燈泡的問題 / TALK: The Lightbulb Keeps Going Out; It Seems to Still Be a Problem With the Bulb

2025-06-13T12:00:00.006+08:00

一直搞不懂為什麼燈泡會時常熄滅的我，在調整了很多次熄滅的燈泡後，我忽然意識到這可能還是燈泡的問題，但是卻不是燈泡本身能不能正常運作的問題。

現在使用的大燈泡 / The Light Bulbs in Use

目前住處使用的燈泡是TVV LED 16W白光，是一個很大的燈泡。

以燈座的大小來看，這個燈泡其實蠻適合的，而且這個燈泡的亮度也比較強。

儘管如此，燈泡還是不時會熄滅，需要手動扭緊或扭鬆，它才能再度點亮。

以前使用的小燈泡 / Previously Used Light Bulbs

不過在這之前，我們的燈泡其實不是這麼大顆，而是像這種比較小顆的省電燈泡。

由於它相對較小，亮度自然也沒有現在換掉的那顆大型燈泡來得亮。放在碩大的燈座裡面，感覺也沒能善用空間。

問題點：橫向的燈座 / The Problem: Horizontal Lamp Holders

由於最近大顆圓形燈泡在熄滅之後一直無法用調整燈座來讓它點亮，我將之前使用的小顆省電燈泡裝了上去來使用。

在安裝的過程中，我忽然意識到，大顆燈泡無法點亮的原因，可能是因為燈泡太大顆了，導致橫向燈座無法正常穩定固定住燈泡而接觸不良。

這樣一說，忽然可以理解為什麼之前使用的都是小燈泡。因為橫向的燈座可能只能支撐這種小型燈泡而已，太大的燈泡就抓不穩了。

當然，這也只是我的假設而已。

由於燈座固定在天花板裝潢的後面，我實在是無法靠自己找到原因。現在先換上小型燈泡，雖然亮度稍微低了一點，但也總比三天兩頭就會熄滅的大顆燈泡來的好吧。

先試試看再說。

不知道怎麼下後設資料？用AI幫你添增索引關鍵字 / Don't Know How to Add Metadata? Use AI to Write Keywords

2025-06-09T12:00:00.008+08:00

我開發了一個家用的倉儲管理系統來記錄家裡物品的收納位置和存量。為了讓我更容易用搜尋找到物品，我使用Google Gemini來解析物品的照片，以此來添增後設資料(metadata)，提高它被檢索找到的機會。使用下來意外地好用，但也有些限制。這篇就記錄一下這種用AI識別照片添增物品後設資料的心得吧。

I developed a home inventory management system to track the location and quantity of items in my house. To make searching for items easier, I use Google Gemini to analyze photos of the items, adding metadata to increase their searchability. It's surprisingly effective, but it also has some limitations. This post documents my experience using AI image recognition to enhance item metadata.

物品管理APP / Inventory Management App

這各物品管理的APP是我用AppSheet創建的應用程式，只供我們家私人共用，不開放其他人取用。它可以用網頁或AppSheet的APP開啟。

AppSheet可以讓我們用關鍵字檢索物品的後設資料。例如我搜尋「剪刀」，可供檢索的後設資料裡面只要有包含「剪刀」兩個字的物品，通通都可以檢索出來。

然而大多時候，我們找物品用的名稱，通常都跟記錄在後設資料的名稱不一樣。像上圖的眼鏡，你會怎麼稱呼它呢？我是把它登記為「迷因墨鏡」啦。

但對其他人來說可能不是如此。別人可能看眼鏡上的光影像是「像素」，所以用「像素」來檢索。這時候居然能夠找到這個眼鏡，為什麼呢？

因為背後AI幫它增加了另一個名稱「像素墨鏡」，因此這樣就能夠順利把它找出來了。太神奇了，AI到底是怎麽做的呢？

系統架構與原理 / System Architecture and Principles

上圖是一般使用AppSheet的時候的架構圖。我們使用者用手機的APP、或是電腦的網頁來上傳物品的照片，並在表單填上簡單地敘述。接著AppSheet應用程式會跟Google Sheet連接，把相關資訊存入Google Sheet，檔案則是會擺在Google Sheet旁邊的Google Drive資料夾底下。

但是在這個架構下，我們必須完整輸入描述物品的後設資料，不然搜尋的時候就找不出來。

接下來我們把AI的部分加上去。除了完整個系統架構會變成如下：

使用者輸入物品照片跟簡單描述。
AppSheet應用程式先把基本資訊保存到Google Sheet中。
AppSheet進入API排隊機制，決定呼叫Gemini的延後時間。
AppSheet將照片跟描述傳送給Gemini呼叫機制。
Gemini呼叫機制將資料重整與打包、設定必要的提示詞後，執行呼叫Gemini API。
Gemini呼叫機制從Gemini取得結果之後，再回傳給AppSheet。
AppSheet將Gemini產生的後設資料保存到Google Sheet。

AppSheet的Bots功能能讓我們在資料有所更新的時候執行RESTful呼叫。呼叫時可以將AppSheet的資料，甚至是照片檔案，用POST的方式傳送到Apps Script。

然而，實際上我們不能直接用AppSheet呼叫Gemini的RESTful API。這是因為AppSheet會將符合需要呼叫的RESTful API的資料，全部同時發出請求。如果我更新10筆資料，那麼在跟App Sheet同步的時候，App Sheet會同時發出10筆請求。如果我們直接將這些請求送給Gemini，那一下子就會因為短期內過多請求而觸發Rate Limitation而被停用。

因此，我在AppSheet真正呼叫Gemini的開頭加上了一個API排隊機制跟延遲執行的功能。如果現在請求很多，那AppSheet會收到一個排隊號碼，並依照排隊號碼的數字延後執行的時間。App Sheet的延遲最多可以延後到30天，之後再執行後續的動作。在記錄資料的當下，我並沒有急著需要檢索的情況，所以可以讓App Sheet延後詢問Gemini的請求。

API排隊機制是用Google Sheet跟Apps Script撰寫而成，本身也可以用RESTful API的形式呼叫。

後面請Gemini分析圖片跟組成提示詞的部分，也是使用Apps Script撰寫。其中呼叫Gemini的方式可以用Apps Script內建的UrlFetchApp來進行：

const url = apiUrl +"?key=" + key
let result =  UrlFetchApp.fetch(url,options)

options參數必須包含提示詞跟圖片的Base64資訊，構成如下：

var headers = {
    "Content-Type": "application/json"
};

var requestBody = {
    "contents": [
        {
            "parts": [
                {
                    "text": getSystemPrompt(title)
                },
                {    
                    'inline_data':{
                        'mime_type': 'image/jpeg',
                        'data': base64Image
                    }
                }
            ]
        }
    ]
};
var options = {
    "method": "POST",
    "headers": headers,
    "payload": JSON.stringify(requestBody)
};

是說上面程式碼的部分我是用inline_data來上傳圖片資訊，不過現在似乎還有GeminiWithFiles的功能可以使用。未來有需要再來用吧。

在getSystemPrompt(title)裡，我除了輸入物品的基本敘述之外，也請Gemini以商店老闆的角度，描述商品品項以及分類。提示詞如下：

`你網路購物平臺的商品管理者。你的工作是根據圖片來填寫三個欄位：

1. 商品名稱：為這張圖片訂定一個商品名稱。${titleDescription}如果有實際上的商品，請用此商品作為名稱。
2. 品項：您描述它的品項。例如顏色、材質、大小等。如果有多種品項，請用「, 」隔開。
3. 分類：列出架位分類名稱。如果有上層與下層分類，中間請用「/」隔開。

最後用JSON格式輸出。

舉例：
\`\`\`\`
{ 
  "商品名稱": "可微波矽膠摺疊保鮮盒",
  "品項": "綠色, 中型",
  "分類": "居家生活/餐廚用具"
}
\`\`\`\`

只要給我「商品名稱」、「品項」、「分類」訊息即可，不要列出其他事項。請用繁體中文或是英文描述。請使用臺灣人習慣的用詞。

根據以下這張圖片。請列出「商品名稱」、「品項」、「分類」。`

不過儘管要求Gemini產生JSON格式，但它有時候仍不會產生完整的JSON。Apps Script有部分程式碼是在修正JSON格式錯誤的情況。

成果展示 / Results Demonstration

接下來就讓我們來看看Gemini看待圖片會給出什麼建議吧。

能夠識別圖片的文字 / Recognizing Text in Photographs

我給Gemini的資訊是「口紅膠」，而Gemini產生的建議是：

商品名稱: Pentel 膠水
品項: 旋轉式, 固體膠
分類: 文具/膠類

口紅膠上的「Pentel」文字被正確識別出來了。Gemini好厲害。

我給Gemini的資訊是「網片連接器」，而Gemini產生的建議是：

商品名稱: 鐵網片專用連接器
品項: 白色, 8入
分類: 居家生活/收納用品

它有看出包裝上的「8個」資訊。雖然這對搜尋比較沒有幫助就是了。

我給Gemini的資訊是「電源延長線旋轉開關 2P母*4 磁吸」，而Gemini產生的建議是：

商品名稱: eleoon 電源延長線
品項: 白色, 4孔
分類: 居家生活/3C家電/電源延長線

其實延長線上面的文字是「Elevon」，Gemini識別錯誤了，可惜。

靠照片跟物品描述產生的正確名稱 / The Correct Name Generated Based on Photos and Item Descriptions

你知道上面這個東西叫做什麼名字嗎？

我給Gemini的資訊是「水管轉接頭四分外快速內」，而Gemini產生的建議是：

商品名稱: 快接式水管接頭
品項: 白色
分類: 居家生活/五金材料/水管/水管接頭

沒有錯，正確名稱是「快接式水管接頭」。

這包在塑膠袋裡面的一堆東西是什麼呢？

我給Gemini的資訊是「浴簾勾」，而Gemini產生的建議是：

商品名稱: 浴簾掛環
品項: 白色
分類: 居家生活/浴室用品

對，其實它不是「勾」，應該說「掛環」才對。Gemini老師我錯了。

這個...要怎麼稱呼它呢？

我給Gemini的資訊是「掛籃網格」，而Gemini產生的建議是：

商品名稱: 網狀晾衣袋
品項: 綠色
分類: 居家生活

哦哦對，網狀！而且Gemini也幫我把綠色標示上去了。

描述錯誤的例子 / Examples of Misrepresentation

當然，Gemini看走眼的情況還是很常見。讓我們來看看那些東西會讓Gemini看錯。

我給Gemini的資訊是「旋轉衣架」，而Gemini產生的建議是：

商品名稱: 圍巾環形掛架
品項: 不鏽鋼
分類: 居家生活/收納整理

它其實是拿來掛被子或大件衣物的，不是拿來掛圍巾的喔。

我給Gemini的資訊是「SIGG瑞士西格隨身瓶使用說明書」，而Gemini產生的建議是：

商品名稱: 瑞士國鐵局使用說明書
品項: 紙質
分類: 交通工具/週邊

跟瑞士國鐵局好像差的有點多，真是令人哭笑不得。

我給Gemini的資訊是「洗鼻器舊型」，而Gemini產生的建議是：

商品名稱: 塑膠水管接頭
品項: 綠色, 多種尺寸
分類: 居家生活/五金材料/水管管件

說是塑膠水管...好像也沒錯啦。但我都跟Gemini說這是洗鼻器了。

我給Gemini的資訊是「電源延長線甜甜圈」，而Gemini產生的建議是：

商品名稱: 電話線捲線器
品項: 白色
分類: 3C家電/電話周邊

就說是電源延長線了呀。

個人資訊拒絕識別 / Refusal to Identify Personal Information

最後我們要注意的是，Gemini會拒絕識別可能含有個人資訊的照片。

這個藥袋上包含了病狀跟醫師的名字，被Gemini拒絕識別。

這是一個普通的痠痛乳膏，但Gemini對於這種藥品類的照片，大多也都會拒絕識別。

這是一把熱溶膠槍，但是Gemini似乎覺得這是危險物品，因此也拒絕識別。

Gemini拒絕識別的時候，API會傳回錯誤資訊，但它只會跟你說「SAFETY」的原因拒絕分析，而不會明確說明原因。我在上面的Gemini呼叫機制有部分的程式碼也在處理這種情況。

結語 / Conclusion

這篇描述了我是如何使用Gemini來添增描述家裡物品的後設資料。Gemini為部分物品添增了有用的額外資訊，這能讓搜尋時更容易被找到。但也有物品Gemini會描述錯誤，而包含個人資訊的物品更是會被Gemini拒絕。

儘管如此，有了Gemini添增的後設資料，它依然為我整理物品帶來極大的便利。舉例來說，我通常不會在手動輸入時描述物品的顏色。但我要求Gemini分析的品項裡，顏色是很常出現的分析結果。因此如果我不確定這東西要怎麼搜尋的話，搜尋顏色可能會是最容易找到的關鍵字。

是說一開始我在Gemini的提示詞加上品項跟分類的分析，其實是想要用在AppSheet裡面的其他欄位。AppSheet可以讓物品添增標籤跟分類，讓我們能夠更仔細地組織物品的瀏覽結構。但後來我發現還是直接用搜尋就好了。家裡的物品以收納地點作為分類，這樣就很夠用了。加上其他的分類架構只會添增整理物品的困擾而已。

當然，你也可以用類似的提示詞，開啟Gemini直接去問他。不過像是這篇這樣把Gemini整合到日常工作的流程中，讓AI協助我們處理資訊更有效率，這才是我認為理想中的AI使用形式。

這篇關於使用AI添增後設資料的做法就到這裡為止了。文章最後要來問大家的是，你覺得Gemini描述物品的成果如何呢？

1. 很不錯！我只要輸入一點文字，它自己就可以幫我補上很多資訊耶！
2. 還好吧。Gemini添增的大部分資訊都跟我描述的一樣，幫助在哪裡？
3. 不可採信。Gemini居然給我錯誤的描述，未來我不小心因此搞錯了怎麼辦？誰負責？
4. 還可以更好吧？提示詞好像還有很多改進的空間？
5. 其他：歡迎在下面留言，分享你的看法吧！

雜談：不是每個API都叫做OpenAI的API / TALK: Not Every API Is Called OpenAI’s API

2025-06-06T12:00:00.007+08:00

最近遇上太多「號稱背後是OpenAI」的大型語言模型API，但實際上並不是「OpenAI的API」的狀況。這種誤解造成實際開發時帶來很大的困擾，我們藉這個機會說明一下吧。

OpenAI的API / OpenAI’s API

https://platform.openai.com/docs/api-reference/introduction

OpenAI API 是一組由 OpenAI 開發的應用程式介面 (API)，讓開發人員可以運用 OpenAI 的 AI 模型，像是 GPT、DALL-E、 Text Embedding等，建構自己的應用程式。它提供程式化的存取途徑，讓使用者可以透過程式碼與這些模型互動，進行像是自然語言處理、影像生成等任務。開發人員可以透過 API 傳送請求，並接收模型產生的結果，進而整合到自己的軟體或服務中。

OpenAI API 支援多種程式語言，讓開發人員可以更彈性地整合到自己的開發環境中。一般常見的語法是使用Python的函式庫openai：

import openai

# 設定 API Key
openai.api_key = "your_openai_api_key"

# 發送請求給 GPT-4o
response = openai.ChatCompletion.create(
    model="gpt-4o",  # 指定使用 GPT-4o
    messages=[
        {"role": "system", "content": "你是一位專業的 AI 助理。"},
        {"role": "user", "content": "請問 OpenAI GPT-4o 的特點是什麼？"}
    ],
    temperature=0.7
)

# 顯示回應
print(response["choices"][0]["message"]["content"])

除此之外，OpenAI API也支援使用curl直接呼叫的方式取用。以下是詢問4o-mini模型的範例：

curl https://api.openai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
     "model": "gpt-4o-mini",
     "messages": [{"role": "user", "content": "Say this is a test!"}],
     "temperature": 0.7
   }'

值得注意的是，OpenAI API 與 ChatGPT 等服務有著完全不同的形態。前者API 是一個基礎工具集，其目的是讓開發者能將API結合到自己的專案中來使用OpenAI的模型；而後者 ChatGPT 則是一個功能完整的產品，以網頁或APP的形式呈現給終端使用者取用。

另一個需要注意的是，你可以看到curl指令在用來傳送請求資料的-d裡面設定了model名稱、messages傳送訊息、temperature溫度，而messages又有role跟content等複雜的結構，這就是OpenAI API特有的請求方式，跟一般使用curl來說並不一樣。簡單來說，如果不是使用對應的網址、輸入參數、分析回傳資料的方式來呼叫，那就無法正確OpenAI API。

https://platform.openai.com/docs/api-reference/embeddings/create

除了使用OpenAI的大型語言模型之外，OpenAI API也可以拿來請求各種不同的服務。其中開發RAG最常用到的就是文本嵌入(text embedding)的相關模型。其他細節請查閱OpenAI的API Reference。

OpenAI 相容 API / OpenAI Compatible API

由於OpenAI在大型語言模型領域一直是領頭羊的角色，其他公司或組織開發的 API就會設計成能與 OpenAI 的 API 格式相容，以便讓開發者可以輕鬆地將使用 OpenAI API 所撰寫的程式碼遷移到自家開發的API上。

https://api-docs.deepseek.com/zh-cn/

近期相當熱門的一個例子就是DeekSeek。DeepSeek 設計了與 OpenAI 相容的 API。這表示開發者可以使用 OpenAI SDK 或任何與 OpenAI API 相容的套裝軟體，透過簡單的設定修改，就能存取 DeepSeek API。這大幅降低了開發者使用 DeepSeek AI 模型的門檻，也是普及市佔率的常見做法。

儘管有人會認為DeepSeek製作相容API的做法是抄襲OpenAI，但通常這種涉及「介面」、「規格」或「標準」類型的設計不會納入專利，因為這對市場競爭和推廣都有很大的幫助，而API背後的模型和實際上的服務才是各家展現專利技術的重點。舉個例子來說，多年前IEEE 1394 (FireWire)被蘋果壟斷，使用時就得收一大筆專類費用。另一邊USB本身不收專利費用，使得USB被廣泛採用。而如今已經沒有設備採用IEEE 1394，但USB Type-C成為了歐盟法規的統一充電標準。從歷史的發展可知，開放給眾人使用「介面」、「規格」和「標準」，不僅可以促進科技技術的普及，也能夠有效推廣自家的產品。

https://ollama.com/blog/openai-compatibility

話說回來，使用跟OpenAI相容API的產品可不只是DeekSeek，就連本機運作大型語言模型第一首選的Ollama本身也可以用相容與OpenAI API的方式呼叫。OpenAI的影響力可見一斑。

為什麼要用OpenAI API？ / Why Use OpenAI API?

我在開發的過程中，有許多人不斷對此提出疑問：「OpenAI的API明明就可以用curl呼叫，那我這個也能用curl呼叫的API，不就也可以直接使用嗎？」

嗯，顯然的，答案是不行。

現今大部分使用大型語言模型的系統都有相容OpenAI API，而OpenAI API需要用特定的參數跟網址(主要是路徑部分)來存取。如果你用不相容的方式呼叫它，自然就會發生錯誤。上圖就是Dify裡面在OpenAI模型設定用了不相容的API所出現的錯誤。其實也就是讀不到而已。

https://github.com/HKUDS/LightRAG

別說像Dify這種力求能夠相容與大部分模型的系統都沒有對客製化的API有直接支援了，像是LightRAG這種研究型的系統，大多也都是設計只用OpenAI API而已。

https://github.com/fatwang2/dify2openai/blob/main/app.js

當然，我知道有人會說，這時候就是拿出設計模式中的「轉接器模式」(adapter pattern)，做一個相容於OpenAI API的轉換介面就好了吧？的確，fatwang2也在dify2openai專案中實作了Dify轉換到OpenAI API的做法，實際上也可以使用。

然而，到頭來還是在用OpenAI API，不是嗎？

結語 / In Closing

https://udn.com/news/story/7240/8527483

OpenAI公司因為ChatGPT的盛行而聲名大噪，而取用GPT等模型的OpenAI API也成為軟體開發中常見的重要元件。現今有許多服務都是號稱「背後具有GPT模型等級」，但實際上是用各自開發的服務包裹起來，這並不代表他們的API就能跟OpenAI API畫上等號。

對於開發者來說，OpenAI API的功能不僅僅只是使用大型語言模型來對話，甚至還需要用到檔案上傳的多模態分析、文本嵌入 (text-embedding)、微調(fine-tuning)等多種進階功能。因此，並不是任何一個支援curl的API，都可以當作是OpenAI API來使用。

AI在行銷上的話術已經夠混亂了，作為開發者，還是有必要釐清技術上實作的細節啊。