本目录包含 XFCE4 桌面环境的各种配置文件。

• 配置文件列表
• 配置文件详解
  • ports.conf
  • audio_env.sh
  • browser_env.sh
  • chinese-env.sh
  • chinese_locale.sh
  • dbus-launch.sh
• 使用方法
• 自定义配置
• 注意事项

文件名称	功能说明
ports.conf	端口配置文件，自定义各服务端口
deb_installer.conf	DEB 软件安装配置，定义可安装的 DEB 包下载地址
audio_env.sh	音频环境配置，PulseAudio 设置
browser_env.sh	浏览器环境配置，设置 Chrome/Chromium 启动参数
chinese-env.sh	中文环境变量配置（LANG、LC_ALL、输入法模块等）
chinese_locale.sh	中文区域设置配置，包含 locale 生成和验证
dbus-launch.sh	DBus 会话配置，解决桌面环境中的 DBus 冲突

端口配置文件，用于自定义各服务端口：

# noVNC 桌面访问端口
NOVNC_PORT=6080

# HTTP 音频流端口 (audio_http_server.py)
AUDIO_HTTP_PORT=8080

# Web 文件服务端口 (audio_player.html 等静态文件)
WEB_FILES_PORT=8888

# PulseAudio TCP 端口
PULSE_TCP_PORT=4713

# VNC 服务端口
VNC_PORT=5901

用途：当默认端口被占用时，可修改此文件自定义端口。修改后需运行 make stop && make start 重启服务。

音频环境配置：

# PulseAudio 运行时目录
export PULSE_RUNTIME_PATH="/run/user/0/pulse"

# HTTP 音频流端口
AUDIO_HTTP_PORT="${AUDIO_HTTP_PORT:-8080}"

用途：配置 PulseAudio 音频服务器环境变量和网络音频支持

浏览器环境配置，主要设置：

# Chrome/Chromium 启动参数
CHROME_FLAGS="--no-sandbox --disable-gpu --disable-dev-shm-usage"
# 中文语言支持
LANGUAGE="zh_CN.UTF-8"

用途：解决浏览器在 Docker/容器环境中的兼容性问题

中文环境变量配置：

export LANG=zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx

用途：设置系统中文语言和输入法框架

中文区域配置：

# 生成中文 locale
locale-gen zh_CN.UTF-8
update-locale LANG=zh_CN.UTF-8

用途：确保系统支持中文显示

DBus 会话配置：

# 创建独立的 DBus 会话
export DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/$(id -u)/bus

用途：避免多个桌面组件之间的 DBus 冲突

启动脚本会自动加载这些配置：

# 在 start_desktop_fixed.sh 中
source ../config/chinese-env.sh
source ../config/browser_env.sh

# 加载中文环境
source config/chinese-env.sh

# 加载浏览器配置
source config/browser_env.sh

如需自定义配置，可直接编辑对应的 .sh 文件：

# 例如：修改输入法框架为 IBus
vim chinese-env.sh
# 将 fcitx 改为 ibus

1. 修改配置后需要重启桌面环境才能生效
2. 配置文件使用 source 命令加载，不是直接执行
3. 文件编码为 UTF-8，请勿使用其他编码保存

---

最后更新: 2026-02-26