本目录包含 XFCE4 桌面环境的所有安装、启动和管理脚本。

• 脚本列表
  • 安装脚本
  • 启动脚本
  • 管理脚本
  • DEB 软件管理脚本
  • 配置脚本
  • 测试脚本
  • 工具脚本
• 快速使用
• 脚本依赖关系
• 注意事项

脚本名称	功能说明
install_xfce4_desktop.sh	精简版安装脚本，安装 XFCE4 桌面环境及必要依赖
install_xfce4_desktop_final.sh	增强版安装脚本，包含更多可选组件和完整配置
install_audio.sh	安装 PulseAudio 音频系统
install_vscode.sh	安装 VSCode Desktop (命令: vscoded)
install_vscode_mcp.sh	安装 VSCode MCP Server 扩展

脚本名称	功能说明
start_desktop.sh	标准桌面启动脚本
start_desktop_fixed.sh	浏览器修复版启动脚本，解决 Chrome 在 Docker 中的兼容问题
start_audio.sh	启动 PulseAudio 音频服务

脚本名称	功能说明
stop_desktop.sh	停止所有桌面服务（Xvfb、x11vnc、websockify、xfce4）
status_desktop.sh	检查桌面环境运行状态
uninstall.sh	完全卸载 XFCE4 桌面环境

脚本名称	功能说明
install_deb_package.sh	DEB 软件安装器，支持从配置文件读取下载地址，自动安装
uninstall_deb_package.sh	DEB 软件卸载器，支持交互式多选菜单和自动模式

./install_deb_package.sh --name obsidian  # 安装指定软件
./install_deb_package.sh --url <URL>       # 从 URL 直接安装
./install_deb_package.sh --all             # 安装所有配置软件
./install_deb_package.sh --list            # 列出可用软件
./install_deb_package.sh --clean           # 清理下载目录

特性：

• 自动检测已下载的 deb 文件，跳过重复下载
• 智能识别 Electron 应用的正确可执行文件
• 自动创建无沙箱包装脚本（Docker 兼容）

./uninstall_deb_package.sh                 # 交互式多选菜单（美观界面）
./uninstall_deb_package.sh -y              # 自动卸载所有
./uninstall_deb_package.sh -n obsidian     # 卸载指定软件
./uninstall_deb_package.sh -l              # 列出已安装软件

交互式菜单操作：

• [j/k] 上下移动
• [空格] 选择/取消选择
• [a] 全选/取消全选
• [回车] 确认
• [q] 退出

脚本名称	功能说明
configure_input_method.sh	配置中文输入法（Fcitx5/IBus）

脚本名称	功能说明
test_all.sh	完整测试脚本，包含浏览器、服务、中文环境、网络等测试

脚本名称	功能说明
proxy.sh	动态代理配置脚本，自动检测并配置代理地址
show_access_info.sh	显示访问地址和连接信息
fix_chrome_docker.sh	修复 Chrome 在 Docker 环境中的运行问题
audio_http_server.py	HTTP 音频流服务器
web_files_server.py	Web 文件服务器

make install   # 安装
make start     # 启动
make stop      # 停止
make status    # 状态
make test      # 测试

# DEB 软件管理
make deb-list               # 列出可安装软件
make deb-install-obsidian   # 安装 Obsidian
make deb-uninstall          # 交互式卸载菜单

cd scripts

# 安装
./install_xfce4_desktop.sh

# 启动
./start_desktop_fixed.sh

# 停止
./stop_desktop.sh

# 状态
./status_desktop.sh

# 测试
./test_all.sh

# DEB 软件管理
./install_deb_package.sh --list
./install_deb_package.sh --name obsidian
./uninstall_deb_package.sh

install_xfce4_desktop.sh
    └── configure_input_method.sh (安装后配置)

start_desktop_fixed.sh
    ├── 依赖 install_xfce4_desktop.sh
    └── 调用 config/*.sh 配置文件

install_deb_package.sh
    └── 读取 config/deb_installer.conf

uninstall_deb_package.sh
    └── 读取 config/deb_installer.conf

test_all.sh
    └── 验证整个环境是否正常

1. 所有脚本需要在项目根目录或 scripts/ 目录下执行
2. 脚本已包含执行权限，如遇问题请运行：chmod +x scripts/*.sh
3. 日志文件输出到 ../logs/ 目录
4. 配置文件位于 ../config/ 目录
5. DEB 软件下载到 /root/Desktop/dl30_downloads/

---

最后更新: 2026-02-26