tuetenk0pp/sharelatex-full

Overleaf Docker镜像（含完整tlmgr包与minted支持）

镜像概述

本镜像基于Overleaf（在线LaTeX编辑平台）构建，集成了完整的TeX Live环境，包含TeX Live包管理器（tlmgr）可获取的所有LaTeX包，并特别添加了对minted的原生支持。旨在为用户提供开箱即用的LaTeX编辑与编译环境，无需手动配置额外依赖，适用于个人或团队的LaTeX文档创作。

核心功能与特性

1. 完整TeX Live包支持

• 预集成TeX Live的全部基础与扩展包，通过tlmgr可直接获取、更新所有官方LaTeX包，无需额外安装。
• 支持各类LaTeX宏包（如amsmath、biblatex、geometry等）及字体包，满足复杂文档排版需求。

2. minted支持

• 内置minted依赖（Python及pygments），无需手动配置即可使用\usepackage{minted}实现代码块高亮，支持多种编程语言（Python、Java、C++等）的语法高亮效果。

3. Overleaf核心功能

• 提供与官方Overleaf一致的Web界面，支持实时预览、多人协作编辑、版本历史记录等功能。
• 兼容Overleaf的项目管理逻辑，支持项目导入/导出、模板管理。

4. 灵活配置与持久化

• 支持数据卷挂载，确保项目文件与配置持久化存储，避免容器重启后数据丢失。
• 可通过环境变量自定义端口、访问权限等参数。

使用场景

• 学术写作：撰写论文、报告等需复杂公式与参考文献的学术文档。
• 技术文档：编写含代码示例的技术手册，利用minted实现代码高亮。
• 团队协作：多人共同编辑LaTeX文档，通过Web界面实时同步修改。
• 快速部署：个人开发者无需本地配置LaTeX环境，通过Docker快速启动编辑平台。

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动容器：

bash
docker run -d \
  --name overleaf-full \
  -p 80:80 \  # 映射Web界面端口（主机端口:容器端口）
  -v overleaf_data:/var/lib/sharelatex \  # 挂载数据卷，持久化项目数据
  tuetenk0pp/sharelatex-full

Docker Compose配置（推荐）

创建docker-compose.yml文件，支持更灵活的配置：

yaml
version: '3'
services:
  overleaf:
    image: tuetenk0pp/sharelatex-full
    container_name: overleaf-full
    ports:
      - "80:80"  # Web界面访问端口
    volumes:
      - overleaf_data:/var/lib/sharelatex  # 项目数据持久化
      - ./texmf-config:/usr/local/texlive/texmf-config  # 自定义TeX配置（可选）
    environment:
      - SHARELATEX_PORT=80  # 容器内服务端口（默认80）
      - TZ=Asia/Shanghai  # 设置时区
    restart: unless-stopped  # 容器退出时自动重启

volumes:
  overleaf_data:  # 自动创建命名卷

启动服务：

bash
docker-compose up -d

访问与使用

1. 容器启动后，通过http://localhost访问Web界面（若修改端口，需对应调整URL端口）。
2. 首次访问需注册管理员账户，后续可创建项目并开始编辑。
3. 在LaTeX文档中使用minted时，直接添加\usepackage{minted}，编译时自动启用代码高亮。

高级配置

自定义TeX包

如需手动安装额外TeX包（尽管已包含全部tlmgr包），可进入容器执行：

bash
docker exec -it overleaf-full tlmgr install <package-name>

修改默认端口

若主机80端口被占用，可修改端口映射（如映射至8080）：

bash
docker run -d -p 8080:80 -v overleaf_data:/var/lib/sharelatex tuetenk0pp/sharelatex-full

数据备份

通过备份数据卷实现项目备份：

bash
docker cp overleaf-full:/var/lib/sharelatex ./overleaf_backup

注意事项

• 容器首次启动时需初始化TeX环境，可能耗时较长（取决于网络与硬件性能）。
• minted依赖Python及pygments，镜像已预安装，无需额外配置。
• 生产环境建议配置HTTPS（可通过Nginx反向代理实现）。