许多Linux ARM设备(如树莓派、香橙派、飞腾派等)用户发现,直接在系统软件源中搜索Telegram客户端时,要么找不到安装包,要么安装后无法正常启动,甚至部分64位ARM设备无法运行32位版本。这通常是因为官方Telegram桌面版主要针对x86架构优化,而ARM架构需要特定的编译版本或第三方兼容方案。本文将从头开始,教你如何在Linux ARM设备上正确安装并稳定使用Telegram。
检查系统架构与准备环境
在开始安装前,需要确认你的设备属于哪种ARM架构,因为不同架构(armhf、aarch64)对应的安装包完全不同。
具体操作说明:
打开终端,输入命令 uname -m查看输出结果。如果显示 armv7l或 armv8l,属于32位ARM(armhf);如果显示 aarch64,则是64位ARM。接着输入 cat /etc/os-release查看系统版本,记录下发行版名称(如Ubuntu、Debian、Armbian等)。确认系统已连接网络,并执行 sudo apt update更新软件源列表。
注意事项/小提示:
- 部分国产ARM设备(如华为鲲鹏)可能使用统信UOS或麒麟系统,其包管理器不同,后续步骤需对应调整。
- 如果
uname -m返回 unknown,请先安装file工具:sudo apt install file,然后执行file /bin/ls查看架构信息。
备用方案:
- 若无法联网,可先通过手机USB共享网络,或使用有线以太网连接。
- 如果系统是64位内核但运行32位用户空间(少见),请按armhf方案处理。
通过官方AppImage包安装(推荐通用方案)
Telegram官方提供了适用于Linux的AppImage便携包,此格式对ARM架构支持较好,且无需复杂编译。
具体操作说明:
访问Telegram官方下载页面 https://desktop.telegram.org/,点击 Get Telegram for Linux,选择 AppImage (64-bit)或 AppImage (32-bit)版本,根据上一步确定的架构下载对应文件。下载完成后,在终端进入文件所在目录,执行 chmod +x Telegram*.AppImage赋予执行权限。然后直接双击运行或通过终端执行 ./Telegram*.AppImage启动程序。
注意事项/小提示:
- 若下载链接无法访问(国内网络限制),请使用代理或从GitHub镜像下载:
https://github.com/telegramdesktop/tdesktop/releases。 - 部分旧版ARM设备需要先安装 FUSE支持:
sudo apt install fuse。 - AppImage文件建议放在 ~/Applications目录下,方便管理。
备用方案:
- 如果AppImage启动后白屏或崩溃,尝试安装 libfuse2库:
sudo apt install libfuse2。 - 对于无图形界面的服务器系统,AppImage无法运行,请跳转至下一节使用命令行客户端。
使用官方Snap包安装(适用于支持Snap的系统)
Snap是另一种跨架构的Linux软件分发方式,Telegram官方提供了ARM版Snap包,安装过程自动化程度高。
具体操作说明:
先确认系统是否支持Snap:执行 snap --version,如果提示未安装,则运行 sudo apt install snapd安装Snap守护进程。安装完成后重启终端或执行 sudo systemctl restart snapd。接着执行 sudo snap install telegram-desktop命令,等待自动下载并安装。安装完成后在应用菜单中找到 Telegram Desktop启动即可。
注意事项/小提示:
- Snap包体积较大(约200MB),且首次启动较慢,请耐心等待。
- 如果安装失败,检查是否开启了AppArmor或SELinux,临时禁用可尝试:
sudo setenforce 0(仅限测试环境)。 - Snap版默认使用沙箱环境,可能无法访问家目录外的文件,如需发送文件请放在 ~/Snap目录下。
备用方案:
- 若
snap install命令卡住,可尝试使用sudo snap install telegram-desktop --edge安装开发版。 - 对于不支持Snap的旧系统(如Debian 10以下),请使用AppImage方案。
编译安装TDesktop(高级用户方案)
如果上述方法均无法运行,或者你需要自定义编译参数,可以从源码编译Telegram桌面版。
具体操作说明:
首先安装编译依赖:sudo apt install git cmake g++ libqt5svg5-dev libssl-dev liblz4-dev libzstd-dev libxxhash-dev libgsl-dev libgcrypt20-dev libgtk-3-dev libayatana-appindicator3-dev。然后克隆源码:git clone --recursive https://github.com/telegramdesktop/tdesktop.git。进入目录后执行 mkdir build && cd build,运行 cmake -DCMAKE_BUILD_TYPE=Release ..配置项目。最后执行 make -j$(nproc)开始编译,整个过程根据设备性能可能需要30分钟到2小时。编译完成后,在 build/bin目录下找到 Telegram可执行文件。
注意事项/小提示:
- ARM设备编译时内存建议至少2GB,否则可能因OOM被杀死。可增加Swap空间:
sudo fallocate -l 4G /swapfile && sudo chmod 600 /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile。 - 如果编译过程中提示缺少某个库,请根据错误信息手动安装对应的
-dev包。 - 编译完成后,可执行
sudo make install将程序安装到系统路径。
备用方案:
- 若编译失败,可尝试使用预编译的 Telegram for Linux ARM第三方包,例如在
https://github.com/telegramdesktop/tdesktop/releases中查找带arm字样的Release。 - 对于树莓派用户,可直接使用Raspberry Pi OS软件源中的版本:
sudo apt install telegram-desktop(但版本可能较旧)。
使用Telegram命令行客户端(无图形界面方案)
如果设备没有显示屏或仅需发送消息,可以使用基于终端的Telegram客户端,如 telegram-cli。
具体操作说明:
安装依赖:sudo apt install git libreadline-dev libconfig-dev libssl-dev lua5.2 liblua5.2-dev libevent-dev libjansson-dev libpython2.7-dev。克隆 telegram-cli源码:git clone https://github.com/vysheng/tg.git && cd tg。执行 ./configure和 make,编译完成后运行 bin/telegram-cli。首次运行需要输入手机号并验证,之后即可通过命令发送消息,例如 msg username 你好。
注意事项/小提示:
- 命令行客户端不支持接收图片、文件等多媒体内容,仅能查看文字消息。
- 输入
/help可查看所有命令列表,退出输入quit。 - 由于该项目已停止维护,部分新功能(如频道、话题)可能不支持。
备用方案:
- 也可使用Python编写的 Telethon库,通过脚本方式操作Telegram,适合自动化任务。
- 对于仅需接收通知的场景,可安装 telegram-notifier等轻量工具。
验证安装与登录测试
完成安装后,需要验证客户端能否正常连接服务器并收发消息。
具体操作说明:
启动Telegram客户端,在登录界面输入你的手机号(需包含国家代码,如中国+86),点击 Next。等待接收短信验证码或Telegram App推送的验证码,输入后点击 Sign In。如果开启了两步验证,再输入密码。登录成功后,尝试搜索一个公开频道(如 @telegram),发送一条测试消息,确认消息能正常发送和接收。最后检查设置中的 连接类型,确保显示为“已连接”。
注意事项/小提示:
- 如果无法收到验证码,请检查手机号是否正确,或尝试通过语音通话方式接收验证码(登录界面有切换选项)。
- 部分网络环境可能屏蔽Telegram的MTProto协议,需配置代理:进入 设置 → 高级 → 连接类型 → 使用自定义代理,填入SOCKS5或HTTP代理信息。
- 首次登录后建议开启云同步,以便在其他设备上同步聊天记录。
备用方案:
- 若登录界面卡在“连接中”,可尝试在终端启动时添加
--proxy=all参数强制使用代理。 - 对于命令行客户端,如果验证码接收失败,可尝试使用
-P 1234参数指定本地端口。
常见问题补充
问:AppImage启动后图标显示异常或无法点击?
答:这通常是由于系统缺少 Qt主题库。执行 sudo apt install qt5-gtk-platformtheme安装GTK主题桥接,然后重启AppImage。
问:编译TDesktop时提示“找不到Qt5”怎么办?
答:先执行 sudo apt install qtbase5-dev qttools5-dev qttools5-dev-tools安装Qt5开发包。如果仍报错,尝试 export CMAKE_PREFIX_PATH=/usr/lib/aarch64-linux-gnu/cmake手动指定路径。
问:在树莓派4B上运行Telegram非常卡顿,如何优化?
答:在启动命令前添加 QT_QPA_PLATFORM=offscreen可禁用硬件加速(但会失去动画效果)。或者降低显示分辨率,关闭Telegram的“自动播放动画”和“使用GPU渲染”选项。
问:如何彻底卸载Telegram?
答:AppImage版直接删除文件即可。Snap版执行 sudo snap remove telegram-desktop。编译版需进入build目录执行 sudo make uninstall,或手动删除 /usr/local/bin/Telegram等文件。
总结:
在Linux ARM设备上安装Telegram,优先选择官方AppImage或Snap包,编译安装仅作为最后手段,且需确保设备内存充足。