fcwu/docker-ubuntu-vnc-desktop 项目开发指南
项目概述
fcwu/docker-ubuntu-vnc-desktop 是一个基于Docker的Ubuntu桌面环境解决方案，通过VNC协议提供远程桌面访问能力。该项目将完整的Ubuntu桌面环境封装在Docker容器中，方便开发者在任何支持Docker的环境中快速部署和使用。
获取项目代码
要开始开发工作，首先需要获取项目代码及其依赖的子模块：
git clone --recursive <项目仓库地址>
如果已经克隆了主仓库但缺少子模块内容，可以执行以下命令获取：
git submodule init
git submodule update
本地测试开发流程
从本地代码重建容器测试
开发者可以修改本地仓库中的代码，然后重新构建Docker容器来测试更改效果：
make clean
FLAVOR=lxqt ARCH=amd64 IMAGE=ubuntu:18.04 make build
make run
参数说明：
FLAVOR：指定桌面环境类型（如lxqt）ARCH：指定架构（如amd64）IMAGE：指定基础镜像（如ubuntu:18.04）
后端开发模式
如果需要开发后端应用，可以采用以下工作流程：
- 首先进入容器shell环境：
make shell
- 停止默认运行的web服务：
service-manager -c /etc/service-manager/service-manager.conf stop web
- 进入后端代码目录并启动调试模式：
cd /src/image/usr/local/lib/web/backend
./run.py --debug
这种开发方式利用了Docker的目录挂载功能，容器中的/src目录会映射到宿主机的项目目录，因此可以直接在宿主机上修改代码，在容器中实时生效。
前端开发模式
前端开发可以采用热重载模式，提高开发效率：
- 进入web前端目录：
cd web
- 安装依赖（首次需要）：
yarn add
- 启动开发服务器：
BACKEND=http://127.0.0.1:6080 npm run dev
参数说明：
BACKEND：指定后端API地址，确保与后端服务地址一致
开发环境最佳实践
-
多阶段构建：项目采用Docker多阶段构建，确保生产镜像最小化，建议开发者保持这一特性。
-
环境变量配置：开发时可以通过环境变量灵活配置各种参数，如桌面环境类型、架构等。
-
调试工具：建议在开发容器中安装必要的调试工具，如gdb、strace等，但注意不要将这些工具包含在最终的生产镜像中。
-
日志查看：开发过程中可以通过
docker logs命令实时查看容器日志，快速定位问题。 -
版本控制：建议为每个功能开发创建独立的分支，保持主分支的稳定性。
常见问题解决
-
子模块更新失败：确保网络连接正常，必要时可以手动下载子模块内容。
-
构建缓存问题：如果构建结果不符合预期，尝试先执行
make clean清除缓存。 -
端口冲突：确保6080等端口没有被其他服务占用，或者修改默认端口配置。
-
权限问题：在Linux系统下开发时，注意Docker需要sudo权限或用户组配置。
通过以上开发指南，开发者可以高效地进行项目定制和功能开发，构建符合特定需求的Ubuntu VNC桌面环境解决方案。
