搭建指南
背景与优势
Overleaf 虽然功能强大且易于上手，但存在以下局限：
- 服务器在国外：访问速度慢，尤其在国内网络环境下体验不佳；
- 自建 Overleaf 麻烦：部署复杂，依赖较多，维护成本高；
- 功能受限：部分高级功能需付费，且无法完全自定义环境。
因此，我们选择基于开源工具自建一个轻量、高效、可定制的 LaTeX Web 编辑器。
技术栈
我们将使用以下技术栈构建：
- code-server：VS Code 的 Web 版本，可在浏览器中运行 VS Code；
- TeX Live（完整版）：提供完整的 LaTeX 编译环境；
- Docker + Docker Compose：实现一键部署、环境隔离与快速迁移；
- LaTeX Workshop 插件：为 VS Code 提供强大的 LaTeX 支持。
最终效果：通过浏览器访问 http://服务器 IP:8002，即可使用功能齐全的 LaTeX 编辑器。
构建镜像
Dockerfile 用于构建包含 code-server 和完整 LaTeX 环境的镜像。
# 基于官方 code-server 镜像（LinuxServer 维护）
FROM linuxserver/code-server:4.103.2
# 切换到 root 用户以安装系统包
USER root
# 替换 APT 源为阿里云镜像，加速国内下载
RUN if [ -f /etc/apt/sources.list ]; then \
sed -i 's@http://.*ubuntu.com@http://mirrors.aliyun.com@g' /etc/apt/sources.list; \
elif [ -f /etc/apt/sources.list.d/debian.sources ]; then \
sed -i 's@http://.*debian.org@http://mirrors.aliyun.com@g' /etc/apt/sources.list.d/debian.sources; \
else \
echo "无法找到 APT 源文件，将使用默认源"; \
fi
# 安装完整版 TeX Live（包含所有宏包）
RUN apt-get update && \
DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \
texlive-full \
&& apt-get clean \
&& rm -rf /var/lib/apt/lists/*
# 安装中文字体支持（文泉驿微米黑 & 正黑）
RUN apt-get update && \
apt-get install -y --no-install-recommends \
fonts-wqy-microhei \
fonts-wqy-zenhei \
&& apt-get clean \
&& rm -rf /var/lib/apt/lists/*
# 切回非 root 用户（code-server 推荐做法）
USER coder
说明：
texlive-full体积较大（约 5GB+），但能避免'缺少宏包'的常见问题。若追求精简，可改用texlive-latex-extra+ 手动安装所需包。
容器编排
用于一键启动服务：
version: '3.8'
services:
code:
image: latex-vscode:latest
container_name: latex-vscode
restart:
