Tinyproxy 輕量級 HTTP 代理伺服器快速部署指南

前言

Tinyproxy 是一個極輕量的 HTTP/HTTPS 代理伺服器，適合在資源受限的嵌入式裝置或 VPS 上快速部署。本文以 Ubuntu 為例，說明從安裝、預設服務管理到進階自訂配置（非 root 執行、修改連接埠、存取控制）的完整流程。

一、環境與安裝

sudo apt-get update && sudo apt-get install -y tinyproxy

安裝完成後，服務會自動以 root 權限啟動，預設監聽 0.0.0.0:8888。

二、系統服務管理（systemd）

三、命令列參數速查

tinyproxy --help
# -d  前景執行（不 daemonize）
# -c  指定替代配置檔
# -h  顯示說明
# -l  顯示授權
# -v  顯示版本

四、預設配置檔解析（/etc/tinyproxy.conf）

• User/Group：啟動後切換至 nobody/nogroup 降權。
• Port 8888：預設監聽連接埠（非特權連接埠，無需 root）。
• Listen：預設監聽所有介面。
• Logfile：/var/log/tinyproxy/tinyproxy.log（不存在僅警告，不阻止啟動）。
• PidFile：/var/run/tinyproxy/tinyproxy.pid（不存在會導致啟動失敗）。
• StartServers 10：初始啟動子程序數。
• Allow 127.0.0.1：預設僅允許本機存取，對外服務需註解或新增允許網段。

五、進階：以一般使用者身份運行自訂實例

適用於無 root 權限或需多實例隔離的場景：

1. 複製執行檔與配置檔

   mkdir -p ~/bin ~/etc
   cp $(which tinyproxy) ~/bin/
   cp /etc/tinyproxy.conf ~/etc/

2. 修改 ~/etc/tinyproxy.conf
   • Port：改為未被佔用的高位連接埠（如 8990）。
   • Allow 127.0.0.1：註解掉以允許所有來源，或新增特定 CIDR。
   • Logfile：/tmp/tinyproxy.log
   • PidFile：/tmp/tinyproxy.pid
3. 啟動與停止

   cd ~/bin
   ./tinyproxy -c ~/etc/tinyproxy.conf   # 啟動
   killall tinyproxy                     # 停止（僅終止當前使用者的進程）

六、驗證代理是否生效

curl -x https://127.0.0.1:8888 https://httpbin.org/ip
# 或在瀏覽器設定 HTTP Proxy 為 Server_IP:Port

七、常見問題排查

• 連線被拒：確認 Allow 規則、防火牆是否放行連接埠、服務是否正在運行。
• 日誌權限錯誤：確保 Logfile/PidFile 目錄可被執行身份寫入。
• HTTPS 穿透：Tinyproxy 支援 CONNECT 方法，客戶端需支援 HTTP Proxy over TLS。