在Linux系统的ARM64架构设备(如树莓派、飞腾、鲲鹏等国产ARM服务器)上安装Telegram时,用户常遇到官方客户端不提供原生ARM64包、依赖库缺失、运行后闪退或无法启动等问题。即使通过命令行安装成功,也可能因系统缺少特定库(如libxcb、libicu)或显示驱动不兼容导致界面异常。本文将手把手教你从零开始,在ARM64 Linux上正确安装并稳定运行Telegram。
准备系统环境与依赖检查
在安装Telegram之前,必须确认你的Linux发行版架构为ARM64,并安装必要的依赖库,否则后续步骤可能失败。
具体操作说明:
1. 打开终端,输入 uname -m并按回车。如果输出 aarch64或 arm64,则说明系统架构正确。
2. 更新软件包索引:运行 sudo apt update(Debian/Ubuntu系)或 sudo dnf check-update(Fedora系)。
3. 安装基础依赖:对于Debian/Ubuntu系,执行 sudo apt install libxcb-xinerama0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 libxcb-shape0 libxcb-xfixes0 libxcb-xkb1 libxcb-xv0 libx11-xcb1 libasound2 libpulse0 libicu-dev libssl-dev libdbus-1-3 libegl1-mesa libgles2-mesa。对于Fedora系,执行 sudo dnf install libxcb xcb-util xcb-util-image xcb-util-keysyms xcb-util-wm alsa-lib pulseaudio-libs libicu openssl dbus mesa-libEGL mesa-libGLES。
注意事项/小提示:
- 如果你的系统是 Arch Linux ARM,请使用
sudo pacman -S libxcb xcb-util xcb-util-wm icu openssl dbus mesa安装依赖。 - 部分依赖包名可能因发行版版本不同略有差异,若安装时报错“未找到软件包”,可尝试去除版本号或搜索包名(如
apt search libxcb)后手动安装。 - 确保系统已安装 wget或 curl,用于后续下载文件。
备用方案:
- 若系统为 openEuler或 KylinOS等国产系统,请优先使用系统自带的软件中心或
yum安装依赖,包名通常以libxcb开头。 - 如果无法通过包管理器安装全部依赖,可尝试安装
qt5-qtbase和qt5-qtx11extras开发包,Telegram的Qt版本依赖会随之自动解决。
下载适用于ARM64的Telegram客户端
官方Telegram桌面版不直接提供ARM64的预编译包,但社区维护的版本(如 telegram-desktop-bin的ARM64构建)或 Flatpak版本均可使用。这里推荐使用官方提供的 Snap包或第三方编译的 AppImage文件。
具体操作说明:
1. 访问 telegram.org官网,点击“获取Telegram”下的“Linux”版本,默认下载的是x86_64架构包,不适用于ARM64。
2. 推荐使用 Snap安装:在终端执行 sudo snap install telegram-desktop。Snap会自动适配ARM64架构。
3. 若不想用Snap,可下载社区编译的ARM64 AppImage。在终端执行:wget https://github.com/telegramdesktop/tdesktop/releases/latest/download/Telegram-ARM64.AppImage(注意:此链接为示例,实际请从 GitHub Releases页面查找带 arm64或 aarch64字样的最新版本)。
4. 下载完成后,赋予执行权限:chmod +x Telegram-ARM64.AppImage。
注意事项/小提示:
- Snap安装方式最省心,但需要系统支持Snap(可通过
snap version检查)。若不支持,先安装Snapd:sudo apt install snapd。 - 如果使用AppImage,请确保下载的文件名包含 arm64,否则可能无法启动。
- 部分ARM64设备(如树莓派4B+)运行AppImage时可能需要安装 FUSE:
sudo apt install fuse。
备用方案:
- 使用 Flatpak:先安装Flatpak(
sudo apt install flatpak),然后运行flatpak install flathub org.telegram.desktop。 - 如果以上方法均不可行,可尝试在ARM64设备上编译源码(不推荐新手,需安装CMake、Qt等开发工具,耗时较长)。
首次运行与登录验证
安装完成后,需要启动Telegram并完成首次登录,以确认程序能在ARM64系统上正常运行。
具体操作说明:
1. 如果使用Snap安装,在应用菜单中找到 Telegram Desktop并点击启动,或终端输入 telegram-desktop。
2. 如果使用AppImage,在终端进入下载目录,执行 ./Telegram-ARM64.AppImage。
3. 启动后,输入你的手机号码,点击 下一步。Telegram会向你的Telegram应用发送登录验证码(注意:不是短信,是Telegram应用内的通知)。
4. 在手机或已登录设备上查看验证码,输入后点击 继续。如有两步验证密码,按提示输入。
注意事项/小提示:
- 首次启动可能较慢(尤其是树莓派等低性能设备),请耐心等待 10-30秒。
- 如果启动后界面空白或卡死,请检查终端输出是否有错误信息(如缺少库文件),然后返回第一步补充依赖。
- 登录时手机必须保持联网,且Telegram应用已登录。
备用方案:
- 如果无法收到验证码,检查手机Telegram的通知权限是否开启,或尝试点击“我没有收到验证码”选择通过短信接收。
- 若启动后立刻闪退,尝试在终端运行
strace ./Telegram-ARM64.AppImage 2>&1 | grep -i error查看缺失的库,然后手动安装对应软件包。
解决中文输入与界面乱码问题
ARM64 Linux上Telegram默认可能无法正常显示中文或输入中文,需要调整字体和输入法配置。
具体操作说明:
1. 打开Telegram,点击左上角 三横线菜单→ 设置→ 聊天设置。
2. 在 字体大小下方,点击 字体,选择支持中文的字体(如 Noto Sans CJK SC或 WenQuanYi Micro Hei)。如果列表中没有,需要先安装中文字体:sudo apt install fonts-noto-cjk fonts-wqy-microhei。
3. 对于中文输入:确保系统已安装 fcitx5或 ibus输入法框架。在终端执行 fcitx5-diagnose检查状态。若未安装,运行 sudo apt install fcitx5 fcitx5-chinese-addons。
4. 设置环境变量:编辑 ~/.bashrc或 ~/.profile,添加以下两行:
`
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
`
保存后执行 source ~/.bashrc生效,然后重启Telegram。
注意事项/小提示:
- 如果使用 ibus,请将上述环境变量中的
fcitx替换为ibus。 - 若界面出现方框或乱码,说明中文字体未正确加载,优先安装 fonts-noto-cjk即可解决。
- 在树莓派等设备上,建议使用 Noto Sans CJK SC字体,渲染效果较好。
备用方案:
- 如果修改环境变量后仍无法输入中文,在Telegram启动时强制指定输入法:
QT_IM_MODULE=fcitx telegram-desktop。 - 对于Wayland显示服务器,可能需要设置
export WAYLAND_IM_MODULE=fcitx。
常见问题补充
问:安装后点击图标无反应,终端也没有任何输出怎么办?
答:首先检查文件是否具有执行权限(ls -l查看),然后尝试在终端直接运行二进制文件(如 /snap/bin/telegram-desktop)并观察错误输出。常见原因是缺少 libpulse或 libdbus,按第一步补充安装即可。
问:AppImage运行时提示“cannot execute binary file: Exec format error”
答:说明下载的文件不是ARM64架构的。请重新检查下载链接,确保文件名包含 arm64或 aarch64。也可通过 file Telegram-ARM64.AppImage查看文件类型,确认是否为 ELF 64-bit LSB executable, ARM aarch64。
问:登录后聊天列表加载极慢,或发送消息延迟严重
答:ARM64设备(尤其是树莓派3B+)性能有限,Telegram的桌面版在低配设备上确实会有卡顿。建议关闭“动画效果”:设置 → 高级 → 关闭“启用动画”。同时减少同时开启的聊天数量。
问:Telegram无法链接代理(如MTProto代理)
答:ARM64版本与x86版本代理功能完全一致。在设置 → 高级 → 连接类型中手动添加代理服务器地址和端口。如果代理软件本身不支持ARM64,请使用 SSH隧道或 Trojan-Go等支持ARM64的工具作为中继。
总结:在ARM64 Linux上安装Telegram的关键在于使用Snap或社区AppImage适配包,并提前装全依赖库;遇到中文显示或输入问题,安装中文字体并正确配置输入法环境即可解决。