Ubuntu 系統安裝 Twisted 網路框架的兩種方法

Twisted 是 Python 知名非同步網路程式框架，支援 TCP、UDP、SSL/TLS、HTTP、SSH、IMAP 等協定。在 Ubuntu 上可透過 pip（源碼編譯）或 apt（預編譯套件）安裝。本文說明兩種方法的適用場景與驗證步驟。

方法一：使用 pip 安裝（推薦開發環境，版本最新）

1. 安裝建構依賴

sudo apt-get update
sudo apt-get install python3-dev python3-pip python3-venv build-essential libssl-dev libffi-dev

2. 建立虛擬環境（最佳實踐）

python3 -m venv ~/venv/twisted
source ~/venv/twisted/bin/activate

3. 安裝 Twisted

pip install --upgrade pip
pip install twisted

或指定版本：pip install twisted==22.10.0

4. 驗證安裝

python -c "import twisted; print(twisted.__version__)"
# 輸出: 22.10.0 (或您安裝的版本)

方法二：使用 apt 安裝（推薦生產/系統級部署，穩定性優先）

1. 直接安裝系統套件

sudo apt-get update
sudo apt-get install python3-twisted

Ubuntu 22.04 LTS 預設提供 Twisted 22.4.0；Ubuntu 24.04 LTS 提供 22.10.0。

2. 安裝額外協定支援（可選）

sudo apt-get install python3-twisted-conch   # SSH
sudo apt-get install python3-twisted-mail    # IMAP/SMTP
sudo apt-get install python3-twisted-web2    # Web2 (舊版)

3. 驗證安裝

python3 -c "import twisted; print(twisted.__version__)"

兩種方法比較

常見問題排除

• error: Microsoft Visual C++ 14.0 is required：Windows 環境缺少建構工具，Linux 不會發生。
• ImportError: No module named 'twisted'：未啟用虛擬環境、或安裝至不同 Python 解譯器。檢查 which python 與 pip show twisted。
• SSL/TLS 功能異常：確認安裝 libssl-dev（apt）或 openssl-devel（RHEL系）後重新 pip install。

快速測試：簡易 Echo Server

# echo_server.py
from twisted.internet import protocol, reactor

class Echo(protocol.Protocol):
    def dataReceived(self, data):
        self.transport.write(data)

class EchoFactory(protocol.Factory):
    def buildProtocol(self, addr):
        return Echo()

reactor.listenTCP(8000, EchoFactory())
reactor.run()

python echo_server.py
# 另開終端: telnet localhost 8000 或 nc localhost 8000

總結

Ubuntu 安裝 Twisted：開發環境請用 pip + venv 獲取最新版與隔離性；生產/容器基底映像請用 apt install python3-twisted 享受安全更新與零編譯依賴。安裝後以 import twisted 驗證即可開始開發高效能非同步網路應用。