在 Linux ARM 设备(如树莓派、香橙派、瑞芯微开发板等)上安装 Telegram,许多用户会遇到找不到官方 ARM 版本、依赖缺失、或运行卡顿的问题。你可能会遇到“无法启动”、“界面显示不全”或“无法登录”等错误提示,甚至根本不知道从哪里下载适用于 ARM 架构的 Telegram 客户端。本文将从零开始,手把手教你如何在 Linux ARM 系统上正确安装、配置并稳定使用 Telegram。
确认系统架构与准备依赖环境
在安装 Telegram 之前,必须确认你的设备是 ARM 架构,并安装好必要的依赖库,否则后续步骤会频繁报错。
具体操作说明:
打开终端,输入 uname -m并回车。如果输出结果包含 aarch64(64位ARM)或 armv7l(32位ARM),则说明设备是 ARM 架构。接着运行 sudo apt update && sudo apt install libx11-dev libxext-dev libxcb-dev libxkbcommon-x11-dev libglib2.0-dev libgtk-3-dev libayatana-appindicator3-dev安装核心图形与系统托盘依赖。
注意事项/小提示:
- 若输出为 x86_64,说明设备是 Intel/AMD 架构,请直接下载常规 x64 版本。
- 某些轻量级 ARM 系统(如 Alpine Linux)需要额外安装 glibc兼容层。
- 安装依赖时如果遇到 E: Unable to locate package,请先执行
sudo apt update更新源。
备用方案:
- 如果系统包管理器无法安装所有依赖,可尝试使用 snap或 flatpak方式安装,它们会自动处理依赖。
- 对于极度精简的 ARM 系统(如 Buildroot),建议直接使用 Telegram Web版本作为替代。
下载官方 Telegram Linux ARM 版本
Telegram 官方并未提供独立的 ARM 安装包,但我们可以通过官方提供的 Telegram Desktop通用 Linux 包,提取其中的 ARM 可执行文件。
具体操作说明:
访问 https://desktop.telegram.org/,点击 Get Telegram for Linux按钮,下载 tsetup.tar.xz文件(这是 x86_64 版本)。然后打开终端,进入下载目录,执行 tar -xf tsetup.tar.xz解压。接着进入解压后的 Telegram目录,找到名为 Telegram的可执行文件。但注意,这个文件是 x86_64 的,我们需要替换为 ARM 版本:使用浏览器访问 https://github.com/telegramdesktop/tdesktop/releases/latest,在页面中找到 Assets部分,下载名为 tsetup.arm64.tar.xz或 tsetup.arm.tar.xz的文件(根据你的架构选择)。
注意事项/小提示:
- 切勿直接运行 x86_64 版本,否则会提示 cannot execute binary file: Exec format error。
- 如果 GitHub 下载速度慢,可使用国内镜像站,如 ghproxy.com。
- 下载后请核对文件完整性,对比 SHA256 校验值(在 Releases 页面可查)。
备用方案:
- 若 GitHub 无法访问,可尝试从 Telegram 官方镜像站(如 telegram.org的备用域名)下载。
- 对于 32 位 ARM 设备,请下载 tsetup.arm.tar.xz,64 位则下载 tsetup.arm64.tar.xz。
解压并运行 Telegram ARM 客户端
将下载的 ARM 版本解压到合适目录,并赋予执行权限,然后首次启动测试。
具体操作说明:
在终端中执行 tar -xf tsetup.arm64.tar.xz(或对应文件名)解压。解压后会得到 Telegram文件夹,将其移动到 /opt/目录下:sudo mv Telegram /opt/。然后进入该目录:cd /opt/Telegram,运行 chmod +x Telegram赋予执行权限。最后执行 ./Telegram启动程序。如果一切正常,Telegram 登录界面将弹出。
注意事项/小提示:
- 首次启动可能会弹出 安全警告,请点击 允许以授权网络访问。
- 如果启动后界面空白或卡死,请检查 GTK3主题兼容性,可尝试设置环境变量
export GTK_THEME=Adwaita再启动。 - 建议使用 绝对路径运行,避免因工作目录问题导致资源加载失败。
备用方案:
- 若
/opt/目录权限不足,可将 Telegram 解压到 ~/Telegram用户目录下运行。 - 对于无图形界面的 ARM 服务器,可使用 Telegram CLI命令行客户端(需单独安装)。
创建桌面快捷方式与自动启动
为了方便日常使用,需要为 Telegram 创建桌面图标,并设置开机自启动。
具体操作说明:
在终端执行 nano ~/.local/share/applications/telegramdesktop.desktop,输入以下内容:
`
[Desktop Entry]
Name=Telegram Desktop
Exec=/opt/Telegram/Telegram
Icon=/opt/Telegram/icon.png
Type=Application
Categories=Network;InstantMessaging;
`
保存后,执行 chmod +x ~/.local/share/applications/telegramdesktop.desktop。接着,进入 设置→ 应用程序→ 启动程序,添加 /opt/Telegram/Telegram作为自启动项。
注意事项/小提示:
- 图标文件 icon.png实际位于解压目录内,可先执行
ls /opt/Telegram/*.png确认文件名。 - 如果桌面环境不显示图标,请尝试注销重新登录。
- 自启动路径中不要使用
~符号,请使用绝对路径。
备用方案:
- 对于 Wayland显示服务器,可能需要额外设置
QT_QPA_PLATFORM=wayland环境变量。 - 如果桌面环境不支持自启动,可在 ~/.bashrc末尾添加
nohup /opt/Telegram/Telegram &实现登录时启动。
验证安装与常见故障排除
启动 Telegram 后,使用手机号登录并测试消息收发,同时处理可能出现的显示或网络问题。
具体操作说明:
点击 Start Messaging,输入你的手机号,点击 Next。等待验证码短信,输入后即可登录。登录成功后,向任意联系人发送一条消息,确认收发正常。如果界面显示异常(如字体过小、按钮重叠),请进入 设置→ Chat Settings→ Font size调整字号。如果网络连接失败,检查防火墙是否放行 443和 80端口。
注意事项/小提示:
- 登录时如果收不到验证码,请检查手机是否屏蔽了国际短信,或尝试使用 Telegram 官方 App发送验证码。
- 如果提示 Connection refused,可能是系统时间不准确,执行
sudo ntpdate pool.ntp.org同步时间。 - 对于 代理用户,请确保已正确配置 SOCKS5 或 HTTP 代理(在设置 → Advanced → Connection Type 中设置)。
备用方案:
- 如果图形界面无法正常渲染,尝试使用 -style Fusion启动参数:
./Telegram -style Fusion。 - 若频繁闪退,检查系统日志:
journalctl -xe | grep telegram,根据错误信息搜索解决方案。
常见问题补充
问:为什么我下载的 tsetup.arm64.tar.xz 解压后无法运行,提示“No such file or directory”?
答:这通常是因为缺少 32位兼容库。执行 sudo dpkg --add-architecture i386 && sudo apt update && sudo apt install libc6:i386安装后重试。
问:Telegram 在树莓派上运行非常卡顿,如何优化?
答:关闭硬件加速,在启动时添加 --disable-gpu参数;或使用 Falkon浏览器打开 Telegram Web 版作为轻量替代。
问:如何更新 Telegram ARM 版本?
答:手动下载新版 tsetup.arm64.tar.xz,解压后覆盖 /opt/Telegram/目录下的文件,重启应用即可。不建议使用包管理器自动更新,因为 ARM 版本非官方源提供。
总结:
在 Linux ARM 设备上安装 Telegram 的关键在于正确下载对应架构的压缩包、安装图形依赖库,并通过手动解压和创建快捷方式完成部署;遇到问题时优先检查系统架构、依赖完整性和网络配置。