numgeom/desktop

NumGeom开发环境Docker镜像

该Docker镜像基于Ubuntu 16.04，为NumGeom提供完整的开发环境。它运行轻量级LXDE窗口管理器，预装Octave 4.0.2、Python 3.5.2（含NumPy、SciPy、Pandas及Spyder）、Jupyter Notebook和Atom编辑器。X窗口可通过浏览器全屏显示，支持64位Linux、Mac或Windows系统，确保用户在不同操作系统上使用一致的编程环境。

![Build Status]([] ![]([]

准备工作

安装Python

若使用Linux或Mac，Python通常已预装，可跳过此步骤。
若使用Windows，需安装Python。推荐安装Miniconda，下载地址：[***]

安装Docker

免费下载Docker Community Edition：[***]

Windows用户注意事项

1. Docker仅支持64位Windows 10 Pro或更高版本。若使用Windows 8或Windows 10 Home，需升级系统。石溪大学学生可免费获取Windows 10 Education：[***] Toolbox支持老系统，但不推荐使用。
2. 安装Docker后可能需要重启电脑以启用虚拟化和Microsoft Hyper-V。若未启用硬件虚拟化，需进入BIOS设置开启。
3. 出于安全考虑，请勿在管理员账户中使用Docker。Docker 17.06及以上版本要求用户账户属于本地“docker-users”组。需登录管理员账户，打开“计算机管理”→“本地用户和组”→“组”，右键点击“docker-users”→“添加到组”，将你的用户名加入。
4. 若之前安装过VMware或VirtualBox，可能与Docker冲突。可通过控制面板的“Windows功能”禁用Hyper-V后重新启用解决。
5. 首次使用Docker需共享C盘：右键点击系统托盘的Docker图标→“设置”→“共享驱动器”，勾选C盘。
6. Docker for Windows默认将镜像和数据卷保存在公共文件夹C:\Users\Public\Documents\Hyper-V\Virtual Hard Disks\MobyLinuxVM.vhdx，存在安全风险。若使用共享电脑，建议创建私有文件夹（如C:\Users\你的用户名\Documents\Hyper-V\Virtual Hard Disks），并在Docker设置的“高级”选项中修改“镜像和卷VHD位置”。

Mac用户注意事项

1. Docker 17.06.0-ce版本存在bug（https://github.com/docker/for-mac/issues/1809%EF%BC%89%EF%BC%8C%E7%94%B5%E8%84%91%E4%BB%8E%E7%9D%A1%E7%9C%A0%E5%94%A4%E9%86%92%E6%88%96%E7%BD%91%E7%BB%9C%E8%AE%BE%E7%BD%AE%E5%8F%98%E5%8C%96%E6%97%B6%E4%BC%9A%E9%87%8D%E5%90%AF%E3%80%82%E8%A7%A3%E5%86%B3%E6%96%B9%E6%B3%95%EF%BC%9A%E5%9C%A8Docker%E5%81%8F%E5%A5%BD%E8%AE%BE%E7%BD%AE%E4%B8%AD%EF%BC%8C%E5%B0%86%E4%BB%A3%E7%90%86%E8%AE%BE%E7%BD%AE%E6%94%B9%E4%B8%BA%E2%80%9CNo Proxy”。
2. Mac上Docker时钟在睡眠唤醒后会滞后，可通过重启Docker或安装sync-docker-time（https://github.com/x11vnc/sync-docker-time%EF%BC%89%E8%A7%A3%E5%86%B3%E3%80%82

Linux用户注意事项

• 大多数Linux发行版提供docker包，可通过系统包管理器安装。部分系统（如OpenSUSE）安装后需运行以下命令启动docker：

sudo systemctl enable docker
sudo systemctl start docker

• 安装后需将用户加入docker组：Ubuntu系统运行sudo adduser $USER docker，其他系统运行sudo usermod -G docker -a $USER。加入后需注销并重新登录生效。

运行Docker镜像

首先下载脚本numgeom_desktop.py并保存到代码和数据所在的工作目录。

Windows：打开PowerShell，cd到工作目录，运行：

curl https://raw.githubusercontent.com/numgeom/docker-desktop/master/numgeom_desktop.py -outfile numgeom_desktop.py

Linux或Mac：打开终端，cd到工作目录，运行：

curl -s -O https://raw.githubusercontent.com/numgeom/docker-desktop/master/numgeom_desktop.py

下载后，启动NumGeom的Octave环境：

python numgeom_desktop.py -p

该命令会下载并运行镜像，自动启动默认浏览器显示桌面环境。-p选项可选，用于拉取最新版本镜像。

开发者若需使用MATLAB：

python numgeom_desktop.py -p -m

-m选项会请求安装MATLAB，需通过Google账户认证下载，之后用MathWorks账户激活（仅需一次）。

查看更多命令选项：

python numgeom_desktop.py -h

作为Jupyter Notebook服务器运行

将numgeom_desktop.py替换为numgeom_jupyter.py即可：
Windows：

curl https://raw.githubusercontent.com/numgeom/docker-desktop/master/numgeom_jupyter.py -outfile numgeom_jupyter.py
python numgeom_jupyter.py -p

Linux或Mac：

curl -s -O https://raw.githubusercontent.com/numgeom/docker-desktop/master/numgeom_jupyter.py
python numgeom_jupyter.py -p

离线运行

已下载镜像后，可离线运行：

python numgeom_desktop.py

或

python numgeom_jupyter.py

停止镜像

在启动镜像的终端（Windows PowerShell）中按两次Ctrl-C，然后关闭浏览器中的桌面标签页。

桌面环境全屏模式

推荐使用VNC Viewer连接（需输入终端显示的端口和密码），支持全屏。若未安装VNC Viewer，也可通过浏览器全屏：

推荐使用Google Chrome或Chromium：

• Windows/Linux：菜单“视图→全屏”，或点击右上角三点菜单中的全屏图标，按F11退出。
• Mac：菜单“视图→进入全屏”，或点击左上角绿色圆圈，按Ctrl-Cmd-f退出。需禁用“全屏时始终显示工具栏”选项。

其他浏览器：

• Windows Edge：按Win+Shift+Enter切换全屏。
• Mac Safari：点击左上角绿色圆圈或菜单“视图→进入全屏”，按Ctrl-Cmd-f退出。
• Linux Firefox：不推荐（地址栏无法隐藏），建议用Chrome/Chromium。若使用Firefox，可点击Docker桌面左侧边栏的“Fullscreen”按钮，但按Esc会退出。

若自动打开的浏览器不推荐，可复制URL到推荐浏览器。

技巧与提示

1. Mac和Windows上Docker默认使用2核CPU和2GB内存。若运行大型任务，可通过Docker设置（系统托盘图标→设置/偏好→高级）调整内存和核心数。
2. Docker桌面中，$HOME/.config、$HOME/.ssh、$HOME/numgeom、$HOME/shared及显式挂载的目录是持久化的，其他目录修改会在容器停止后丢失。推荐用$HOME/shared（映射到主机工作目录）存储代码和数据。
3. Docker中的$HOME/.ssh映射到主机的.ssh目录，方便使用SSH密钥访问Git仓库。需在终端运行ssh-add添加密钥到ssh-agent。
4. 主机与Docker桌面间的复制粘贴可通过左侧工具栏的“Clipboard”框同步：从Docker复制到主机，先选中文本再到Clipboard复制；从主机到Docker，先粘贴到Clipboard再在Docker中粘贴。
5. 停止容器的正确方式：使用Docker桌面左下角的“logout”按钮；或在启动脚本的终端按两次Ctrl-C；或运行docker stop <容器ID>（用docker ps -a查看ID）。不要仅关闭浏览器窗口，否则容器会在后台继续运行。