PyCharm

镜像概述和主要用途

PyCharm 是由捷克公司JetBrains开发的集成开发环境（IDE），专为Python编程语言设计。该Docker镜像基于Arch Linux构建，提供最新稳定版PyCharm，支持代码分析、图形化调试器、集成单元测试、版本控制系统（VCS）集成及Django web开发框架，适用于需要便捷部署和隔离的Python开发环境。

核心功能和特性

• 完整Python开发环境：集成代码分析、语法高亮、自动补全和重构工具
• 调试与测试：内置图形化调试器和单元测试框架，支持断点调试和测试用例管理
• 版本控制集成：兼容Git、SVN等主流版本控制系统
• Web开发支持：原生支持Django框架，提供模板编辑、数据库工具等功能
• 多方式访问：支持VNC客户端和noVNC web界面两种访问方式
• 数据持久化：通过挂载卷实现配置文件和项目数据的持久化存储
• 权限控制：可自定义用户ID（PUID）和组ID（PGID），确保文件权限兼容
• 扩展能力：支持启动脚本安装额外系统包或AUR软件

使用场景和适用范围

• 个人开发者快速搭建隔离的Python开发环境
• 团队协作时统一开发工具版本和配置
• 需要通过远程访问进行Python开发的场景
• 集成到CI/CD流程中的开发或测试环境

详细使用方法和配置说明

基本部署命令

docker run -d \
    -p 5900:5900 \
    -p 6080:6080 \
    --name=<容器名称> \
    --security-opt seccomp=unconfined \
    -v <配置文件路径>:/config \
    -v <数据文件路径>:/data \
    -v /etc/localtime:/etc/localtime:ro \
    -e HTTPS_CERT_PATH=<证书文件路径> \
    -e HTTPS_KEY_PATH=<密钥文件路径> \
    -e WEBPAGE_TITLE=<浏览器标签名称> \
    -e VNC_PASSWORD=<web界面密码> \
    -e ENABLE_STARTUP_SCRIPTS=<yes|no> \
    -e HEALTHCHECK_COMMAND=<健康检查命令> \
    -e HEALTHCHECK_ACTION=<健康检查动作> \
    -e HEALTHCHECK_HOSTNAME=<健康检查主机名> \
    -e UMASK=<创建文件的umask值> \
    -e WEBUI_PORT=<web界面端口> \
    -e PUID=<用户UID> \
    -e PGID=<用户GID> \
    binhex/arch-pycharm

注意：请将上述命令中所有<>定义的用户变量替换为实际值。

参数说明

端口映射（-p）

• 5900:5900：VNC服务端口，用于VNC客户端连接
• 6080:6080：noVNC web界面端口，用于浏览器访问

容器设置

• --name=<容器名称>：指定容器名称（如pycharm）
• --security-opt seccomp=unconfined：禁用seccomp限制，确保PyCharm正常运行

挂载卷（-v）

• <配置文件路径>:/config：持久化PyCharm配置（如/apps/docker/pycharm:/config）
• <数据文件路径>:/data：挂载项目数据目录（如/apps/docker/pycharm/projects:/data）
• /etc/localtime:/etc/localtime:ro：同步主机时间（只读挂载）

环境变量（-e）

• HTTPS_CERT_PATH：HTTPS证书文件路径（可选）
• HTTPS_KEY_PATH：HTTPS密钥文件路径（可选）
• WEBPAGE_TITLE：浏览器标签显示名称（如Python IDE）
• VNC_PASSWORD：web界面访问密码（必填）
• ENABLE_STARTUP_SCRIPTS：是否启用启动脚本（yes/no，默认no）
• UMASK：创建文件的umask值（如000）
• WEBUI_PORT：web界面端口（默认6080）
• PUID/PGID：运行容器的用户/组ID（通过id <用户名>命令获取）

部署示例

docker run -d \
    -p 5900:5900 \
    -p 6080:6080 \
    --name=pycharm \
    --security-opt seccomp=unconfined \
    -v /apps/docker/pycharm:/config \
    -v /apps/docker/pycharm/projects:/data \
    -v /etc/localtime:/etc/localtime:ro \
    -e WEBPAGE_TITLE=Tower \
    -e VNC_PASSWORD=mypassword \
    -e ENABLE_STARTUP_SCRIPTS=yes \
    -e UMASK=000 \
    -e WEBUI_PORT=6080 \
    -e PUID=0 \
    -e PGID=0 \
    binhex/arch-pycharm

访问方式

通过web界面访问（noVNC）

使用浏览器访问以下URL（替换<主机IP>和<主机端口>）：

http://<主机IP>:<主机端口>/vnc.html?resize=remote&host=<主机IP>&port=<主机端口>&&autoconnect=1

示例：

[***]

通过VNC客户端访问

使用VNC客户端连接以下地址（替换<主机IP>）：

<主机IP>::5900

示例：

192.168.1.10::5900

注意事项

启动脚本扩展

当ENABLE_STARTUP_SCRIPTS=yes时，可通过/config/home/scripts/目录下的脚本安装额外软件包。目录中提供示例脚本example-startup-script.sh，包含Arch仓库和AUR包安装指南。

用户权限配置

获取当前用户的PUID和PGID：

id <用户名>

输出示例：uid=1000(user) gid=1000(user) ...，其中1000分别为PUID和PGID。