jare/emacs

Docker化的Emacs GUI镜像（支持Mac、Windows、GNU/Linux及浏览器）

镜像概述

本镜像将Emacs封装为Docker容器，支持在MacOS、Windows、GNU/Linux系统上通过GUI运行，结合https://github.com/JAremko/docker-x11-bridge%E8%BF%98%E5%8F%AF%E5%9C%A8%E6%B5%8F%E8%A7%88%E5%99%A8%E4%B8%AD%E8%AE%BF%E9%97%AEEmacs%EF%BC%8C%E5%AE%9E%E7%8E%B0%E8%B7%A8%E5%B9%B3%E5%8F%B0%E7%9A%84%E4%B8%80%E8%87%B4%E4%BD%BF%E7%94%A8%E4%BD%93%E9%AA%8C%E3%80%82

核心功能

• 在Windows/MacOS机器上使用Emacs及其他GNU/Linux工具
• 通过Docker Hub自动构建环境并免费存储完整备份
• 一次构建，随处使用统一开发环境
• 在可调沙箱中运行不可信/高风险代码，支持CPU/网络/磁盘配额
• 尝试新工具、实验并在出错时回滚更改
• 共享设置或扩展他人的开发环境
• 在同一机器上隔离运行多个Emacs实例
• 轻松切换Emacs版本（如emacs26、emacs25、emacs-snapshot）用于调试
• 暂停容器临时释放资源
• Checkpoint & Restore功能快速启动“重型”环境
• 对低上传速度/配额的网络友好

使用场景

• 跨平台开发人员需要统一的Emacs开发环境
• 需要隔离运行风险代码的用户
• 想要快速切换Emacs版本进行调试的开发者
• 需要共享开发环境的团队
• 实验新工具或配置时需要快速回滚的场景

配置说明

前置条件

首先安装对应系统的Docker：Docker安装指南

MacOS

1. 安装XQuartz
2. 打开XQuartz，在偏好设置的“安全”选项卡中勾选“允许网络客户端连接”
3. 执行以下命令：

bash
ip=$(ifconfig en0 | grep inet | awk '$1=="inet" {print $2}')
xhost + $ip
docker run -ti --name emacs\
 -e DISPLAY=$ip:0\
 -e UNAME="emacser"\
 -e GNAME="emacsers"\
 -e UID="1000"\
 -e GID="1000"\
 -v <你的.emacs.d路径>:/home/emacs/.emacs.d\
 -v <你的工作区路径>:/mnt/workspace\
 jare/emacs emacs

Windows

1. 安装Cygwin，并选择安装xinit、xorg-server，可选winpty
2. 执行以下命令：

bash
export DISPLAY=<你的机器IP>:0.0
startxwin -- -listen tcp &
xhost + <你的机器IP>

3. 运行容器（无winpty）：

bash
docker run --name emacs\
 -e DISPLAY="$DISPLAY"\
 -e UNAME="emacser"\
 -e GNAME="emacsers"\
 -e UID="1000"\
 -e GID="1000"\
 -v <你的.emacs.d路径>:/home/emacs/.emacs.d\
 -v <你的工作区路径>:/mnt/workspace\
 jare/emacs emacs

或使用winpty：

bash
winpty docker run -ti --name emacs\
 -e DISPLAY="$DISPLAY"\
 -e UNAME="emacser"\
 -e GNAME="emacsers"\
 -e UID="1000"\
 -e GID="1000"\
 -v <你的.emacs.d路径>:/home/emacs/.emacs.d\
 -v <你的工作区路径>:/mnt/workspace\
 jare/emacs emacs

GNU/Linux

确保$DISPLAY变量已设置，执行以下命令：

bash
docker run -ti --name emacs -v /tmp/.X11-unix:/tmp/.X11-unix:ro\
 -e DISPLAY="unix$DISPLAY"\
 -e UNAME="emacser"\
 -e GNAME="emacsers"\
 -e UID="1000"\
 -e GID="1000"\
 -v <你的.emacs.d路径>:/home/emacs/.emacs.d\
 -v <你的工作区路径>:/mnt/workspace\
 jare/emacs emacs

若无法运行，可尝试允许本地连接：

bash
xhost +si:localuser:<UNAME>
# 或
xhost +local:`docker inspect --format='{{ .Config.Hostname }}' emacs`

基础Docker命令

• docker rm -f emacs：删除emacs容器
• docker restart emacs：重启emacs容器
• docker rmi -f jare/emacs：删除jare/emacs镜像
• docker pull jare/emacs：拉取最新版本镜像
• docker run ... jare/emacs：运行默认命令
• docker run -ti ... jare/emacs /bin/bash：启动bash
• docker exec emacs /usr/bin/emacs：在运行的容器中启动Emacs
• docker logs emacs：查看容器日志
• docker cp <本地路径> emacs:/<容器路径>：复制文件到容器
• docker cp emacs:/<容器路径> <本地路径>：从容器复制文件到本地
• docker volume create --name my-workspace：创建持久化卷
• docker run ... -v my-workspace:/mnt/workspace ... jare/emacs：使用持久化卷