C# 實作飛信 (Fetion) 協議輕量級 SDK 設計心得

飛信 (Fetion) 曾為中國移動推出的即時通訊服務，提供免費短信功能。早期開源 SDK 多基於反編譯官方客戶端，體積龐大 (30MB+)、相依性複雜，難以在 ASP.NET 等伺服器環境部署。本文分享從零分析協議、用 C# 實作輕量級 SDK (僅含登入、登出、發送短信核心功能) 的關鍵技術點與設計取捨。

協議分析切入點

• 參考 PHP/Python 開源實作 (如 libfetion、fetion-php) 理解協議流程。
• 核心流程：SSI 註冊 → SIP 註冊 → 認證授權 → 發送短信 (SIP MESSAGE) → 登出。
• 傳輸層：TCP 長連線，部分階段使用 TLS。
• 編碼：**全協議統一 UTF-8**，長度欄位為 UTF-8 編碼後的位元組數 (非字元數)。

核心類別設計

namespace FetionClient
{
    public sealed class FetionClient : IDisposable
    {
        private readonly string _mobile;
        private readonly string _password;
        private TcpClient _tcpClient;
        private NetworkStream _stream;
        private readonly SemaphoreSlim _sendLock = new SemaphoreSlim(1, 1);

        public FetionClient(string mobile, string password)
        {
            _mobile = mobile;
            _password = password;
        }

        public bool Login()
        {
            _tcpClient = new TcpClient("nav.fetion.com.cn", 5222); // 或其他入口
            _stream = _tcpClient.GetStream();
            // 1. SSI 註冊 (HTTP over TCP)
            // 2. SIP 註冊 + Digest 認證
            // 3. 取得 sip:uri、auth-token
            return PerformSsiRegistration() && PerformSipRegistration();
        }

        public bool SendSms(string targetMobile, string content)
        {
            if (_stream == null) return false;
            // 組裝 SIP MESSAGE 請求
            var msg = BuildSipMessage(targetMobile, content);
            return SendMessage(msg);
        }

        public void Logout()
        {
            // 發送 SIP BYE / Registration expire=0
            Dispose();
        }

        public void Dispose()
        {
            _stream?.Dispose();
            _tcpClient?.Dispose();
        }

        // 內部協議組裝/解析方法略...
    }
}

關鍵技術難點與解法

使用範例

using (var fetion = new FetionClient("13800138000", "password123"))
{
    if (fetion.Login())
    {
        fetion.SendSms("13900139000", "測試訊息 from C# SDK");
        fetion.Logout();
    }
}

法律與道德聲明

• 本 SDK 僅供**學習研究**協議分析與網路程式設計使用。
• **嚴禁**用於垃圾短信、騷擾、駭客攻擊、繞過限流等非法用途。
• 使用者需自行承擔法律風險，作者不負連帶責任。
• 飛信服務已於 2022 年停止運營，此專案僅具歷史教學價值。

後續可擴充方向

• 支援接收短信/狀態報告 (需維持長連線處理推播)。
• 實作好友列表、群組、狀態更新等完整 SIP/SIMPLE 功能。
• 移植至 .NET Standard 2.0 / .NET 6+，支援 Linux 容器化部署。
• 加入單元測試 (Mock TCP 協議)、CI/CD 自動化建置。