ARM架构银河麒麟V10服务器版安装Firefox
前言
银河麒麟V10服务器版是纯命令行系统，默认不包含图形界面和浏览器。但在某些场景下（如自动化测试、内网网页运行某些服务界面、爬虫、Selenium等），需要在服务器上安装Firefox并以无头模式（headless）运行。
环境信息
- 操作系统：银河麒麟V10服务器版（Kylin V10 Server）
- 架构：ARM64（aarch64）
- 系统类型：无图形界面的命令行系统
- 使用场景：自动化测试、网页截图、Selenium、爬虫等
安装前准备
1. 确认系统架构
# 查看系统架构（必须是aarch64）
uname -m
# 查看系统版本
cat /etc/os-release
[root@host200 ~]# cat /etc/os-release
NAME="Kylin Linux Advanced Server"
VERSION="V10 (Halberd)"
ID="kylin"
VERSION_ID="V10"
PRETTY_NAME="Kylin Linux Advanced Server V10 (Halberd)"
ANSI_COLOR="0;31"
[root@host200 ~]# uname -a
Linux host200 4.19.90-89.11.v2401.ky10.aarch64 #1 SMP Thu Apr 25 18:20:10 CST 2024 aarch64 aarch64 aarch64 GNU/Linux
[root@host200 ~]#
2. 更新系统软件源
# 更新软件包列表
sudo yum update -y
# 或使用dnf（较新版本）
sudo dnf update -y
3. 安装必要依赖
服务器版需要安装图形库依赖，即使不显示图形界面：
# 安装基础依赖库
sudo yum install -y \
gtk3 \
dbus-glib \
libXt \
libxcb \
alsa-lib \
libXtst \
libXrender \
libXcomposite \
libXdamage \
libXrandr \
mesa-libgbm \
libxshmfence
# 安装字体支持（避免中文乱码）
sudo yum install -y \
wqy-microhei-fonts \
wqy-zenhei-fonts \
xorg-x11-fonts-misc
安装方法
方法一：使用yum安装（推荐）
# 直接从官方源安装Firefox
sudo yum install -y firefox
# 查看安装版本
firefox --version
方法二：手动下载安装最新版
1. 下载ARM64版本
# 创建下载目录
mkdir -p /opt/firefox
cd /opt/firefox
# 下载最新版Firefox（ARM64架构）
wget -O firefox-latest-arm64.tar.bz2 \
"https://download.mozilla.org/?product=firefox-latest&os=linux64-aarch64&lang=zh-CN"
# 如果wget下载慢，可以使用国内镜像（需要找到可用的镜像源）
2. 解压并配置
# 解压文件
tar -xjf firefox-latest-arm64.tar.bz2
# tar -xvf firefox-147.0.3.tar.xz
# 创建符号链接
sudo ln -sf /opt/firefox/firefox /usr/local/bin/firefox
# 验证安装
firefox --version
# Mozilla Firefox 147.0.3
[root@host200 firefox]#
3. 配置环境变量（可选）
# 添加到系统PATH
echo 'export PATH=/opt/firefox:$PATH' | sudo tee -a /etc/profile.d/firefox.sh
source /etc/profile.d/firefox.sh
无头模式使用
基础命令
# 无头模式启动（不显示界面）
firefox --headless --screenshot https://www.baidu.com
# 指定窗口大小截图
firefox --headless --window-size=1920,1080 --screenshot=baidu.png https://www.baidu.com
# 导出PDF
firefox --headless --print-to-pdf=output.pdf https://www.example.com
# 在后台运行（用于Selenium等）
firefox --headless --remote-debugging-port=9222 &
常用参数说明
--headless：无头模式运行--screenshot：截取网页截图--window-size=宽,高：设置窗口大小--print-to-pdf：导出为PDF--remote-debugging-port：开启远程调试端口（用于Selenium）--no-sandbox：禁用沙箱（某些环境需要）--disable-gpu：禁用GPU加速
常见问题处理
问题1：启动报错 “no display specified”
# 方案1：使用无头模式
firefox --headless --screenshot https://www.example.com
# 方案2：设置虚拟显示
export DISPLAY=:99
Xvfb :99 -screen 0 1920x1080x24 &
问题2：缺少依赖库
# 查看缺少的库
ldd /opt/firefox/firefox | grep "not found"
# 安装缺失的依赖（根据实际情况调整包名）
sudo yum install -y <缺失的包名>
问题3：中文显示乱码
# 安装中文字体
sudo yum install -y \
wqy-microhei-fonts \
wqy-zenhei-fonts \
google-noto-sans-cjk-fonts
# 更新字体缓存
sudo fc-cache -fv
问题4：权限不足
# 如果以非root用户运行，需要调整权限
sudo chown -R $USER:$USER ~/.mozilla
sudo chmod -R 755 ~/.mozilla
# 或者使用--no-sandbox参数（不推荐生产环境）
firefox --headless --no-sandbox --screenshot https://www.example.com
问题5：进程残留
# 查找Firefox进程
ps aux | grep firefox
# 强制终止所有Firefox进程
pkill -9 firefox
# 清理临时文件
rm -rf /tmp/.X*-lock
rm -rf /tmp/rust_mozprofile*
问题6：内存不足
# 限制Firefox内存使用
firefox --headless --screenshot \
--memory-limit=512 \
https://www.example.com
# 或使用systemd限制资源
# 在service文件中添加：
# MemoryLimit=1G
# CPUQuota=50%
性能优化
1. 禁用不必要的功能
创建配置文件 ~/.mozilla/firefox/profiles.ini 或使用命令行参数：
# 禁用GPU加速
firefox --headless --disable-gpu
# 禁用扩展
firefox --headless --safe-mode
# 禁用缓存
firefox --headless --disk-cache-size=0
卸载方法
# 卸载yum安装的版本
sudo yum remove firefox
sudo yum autoremove
# 删除手动安装的版本
sudo rm -rf /opt/firefox
sudo rm -f /usr/local/bin/firefox
# 清理配置文件（可选）
rm -rf ~/.mozilla
# 清理临时文件
rm -rf /tmp/rust_mozprofile*
监控和日志
查看Firefox日志
# 启用详细日志
export MOZ_LOG=all:5
export MOZ_LOG_FILE=/tmp/firefox.log
# 运行Firefox
firefox --headless --screenshot https://www.example.com
# 查看日志
cat /tmp/firefox.log
注意事项
- 架构匹配：必须下载ARM64（aarch64）版本，x86_64版本无法运行
- 依赖完整：服务器版需要手动安装图形库依赖
- 无头模式：服务器环境必须使用
--headless参数 - 资源限制：注意内存和CPU使用，避免影响其他服务
- 安全考虑：生产环境避免使用
--no-sandbox参数 - 版本更新：定期检查并更新Firefox和GeckoDriver版本
- 进程管理：使用完毕后及时关闭Firefox进程，避免资源泄漏