讀卡機

sudo apt update

sudo apt install -y pcscd pcsc-tools libccid

sudo systemctl enable pcscd

sudo systemctl start pcscd

測試讀卡機與卡片： 將你的讀卡機接上電腦，並插入自然人憑證（晶片朝上插入），然後執行：

Bash

pcsc_scan

如果畫面有跳出讀卡機的型號，並且在下方顯示偵測到卡片（通常會看到 Taiwan 或是卡片的晶片規格資訊），代表底層硬體運作正常。確認無誤後，請按下 Ctrl + C 退出該畫面。

第二階段：下載與執行 HiCOS 跨平台網頁元件

內政部官方目前提供的 Linux 版本為一個打包好的本地端伺服器（Local Server），不需特別編譯。

1. 前往官網下載： 請至 內政部憑證管理中心 - 跨平台網頁元件下載頁，下載 Linux版 (HiPKILocalSignServerApp.tar.gz)。

2. 解壓縮並執行程式： 假設你的檔案下載到 ~/Downloads (下載) 資料夾，請在終端機執行：

3. Bash

cd ~/Downloads

# 解壓縮檔案 (檔名若有更新版號，請依照實際下載的檔名微調，或輸入 HiPKI 後直接按 Tab 鍵自動補齊)

tar -zxvf HiPKILocalSignServerApp.tar.gz

# 進入解壓縮後的資料夾

cd HiPKILocalSignServerApp

# 執行啟動腳本

bash ./start.sh

4. 
   

5. 執行後，這個程式會在背景跑一個本地伺服器（Port 61161），這是用來與報稅或政府公文網頁溝通用的橋樑。

第三階段：測試與驗證

1. 請打開你的網頁瀏覽器（推薦使用 Chrome、Edge 或 Firefox）。

2. 在網址列輸入測試網址：http://localhost:61161/selfTest.htm

3. 網頁開啟後，如果看到畫面顯示連線成功，且下方有出現讀卡機名稱與卡片資訊，你可以嘗試輸入 PIN 碼（預設為民國出生年月日共 6 碼）進行「簽章測試」。

4. 只要自我檢測通過，你就可以前往報稅網站或是政府各大入口網站正常登入使用了！

💡 進階技巧：設定開機自動啟動

每次重開機都要開啟終端機手動執行 start.sh 會有點麻煩。解壓縮的資料夾內通常會有一個 startInvisible.desktop（或類似名稱的 .desktop）檔案，你可以將它複製到系統的自動啟動目錄中：

Bash

# 建立 autostart 資料夾（如果還沒有的話）

mkdir -p ~/.config/autostart

# 將啟動捷徑複製過去

cp ~/Downloads/HiPKILocalSignServerApp/startInvisible.desktop ~/.config/autostart/

這樣下次重開機時，Ubuntu 24.04 就會在登入桌面後，於背景自動幫你把 HiCOS 元件準備好。