t4skforce/sharelatex-full Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Docker Sharelatex-full

镜像概述和主要用途

该镜像为官方ShareLaTeX的扩展版本，在其基础上预装了texlive-full包和tlmgr完整方案，旨在提供尽可能多的LaTeX包，避免用户因缺少包而导致的编译问题。其核心价值在于无需额外配置即可使用丰富的LaTeX环境，缺点是镜像体积较大。

核心功能和特性

• 基于官方镜像：扩展自官方ShareLaTeX镜像
• 完整LaTeX环境：预装texlive-full包（包含大量LaTeX工具和宏包）
• tlmgr支持：集成tlmgr（TeX Live包管理器）完整方案，便于管理和更新LaTeX包
• 即开即用：无需手动安装额外LaTeX包，减少配置成本

使用场景和适用范围

• 需要编写包含复杂公式、图表或特殊格式的LaTeX文档的用户
• 希望避免因缺少LaTeX包导致编译错误的场景
• 学术写作、技术文档编写等对LaTeX环境有较高要求的场景

使用方法和配置说明

基本使用

该镜像的使用方式与官方ShareLaTeX镜像一致。由于ShareLaTeX依赖MongoDB和Redis，推荐通过docker-compose进行部署。

Docker Compose配置示例

修改官方docker-compose.yml中的ShareLaTeX镜像为t4skforce/sharelatex-full，示例配置如下：

yaml
version: '2'
services:
  sharelatex:
    image: t4skforce/sharelatex-full
    restart: always
    depends_on:
      - mongo
      - redis
    environment:
      - SHARELATEX_MONGO_URL=mongodb://mongo:27017/sharelatex
      - SHARELATEX_REDIS_URL=redis://redis:6379
      - SHARELATEX_APP_NAME=ShareLaTeX
    ports:
      - "80:80"
    volumes:
      - sharelatex_data:/var/lib/sharelatex

  mongo:
    image: mongo:4.4
    restart: always
    volumes:
      - mongo_data:/data/db

  redis:
    image: redis:6
    restart: always
    volumes:
      - redis_data:/data

volumes:
  sharelatex_data:
  mongo_data:
  redis_data:

首次登录

参考Overleaf官方文档《创建和管理用户》进行用户创建和权限配置。

构建方法

由于TeX Live仓库下载速度较慢，建议先本地获取TeX Live资源，再构建镜像：

本地获取TeX Live资源

• 克隆仓库：

  bash
  wget -c --mirror --no-parent [***]
  

• 或下载ISO镜像：[***]

构建镜像

1. 创建网络：

   bash
   docker network create build_sharelatex
   

2. 启动本地Nginx提供TeX Live资源：

   bash
   docker run --network build_sharelatex --name nginx -v $PWD:/usr/share/nginx/html:ro -d nginx
   

3. 构建镜像（需修改Dockerfile以使用本地Nginx资源）：

   bash
   docker build --network build_sharelatex -t sharelatex-full .
   

故障排除

在内核4.19及以上版本中，overlay文件系统的metacopy配置默认值从N改为Y，可能导致构建问题。执行以下命令解决：

bash
echo N | sudo tee /sys/module/overlay/parameters/metacopy