添加中文字体

2026-06-24 15:52:40 +08:00
parent 7163ca67f9
commit 1b08f2c4a2
8 changed files with 246 additions and 45 deletions
@@ -32,15 +32,11 @@ docker load -i qgis-34411.tar

 ```bash
 # ---- Linux / macOS ----
-
-PROJECT_ROOT=/home/xian/xian_algorithm_new
-FILE_STORE=/data
-
 docker run -d \
  --name qgis-server \
  --restart unless-stopped \
-  -v "${PROJECT_ROOT}:/app:ro" \
-  -v "${FILE_STORE}:${FILE_STORE}" \
+  -v "/www/wwwroot/xian_algorithm_new:/app:ro" \
+  -v "/www/wwwroot/xian_algorithm_new/files:/files" \
  qgis/qgis:3.44.11 \
  sleep infinity

@@ -124,60 +120,103 @@ docker exec qgis-server ls -la /data/template/earthquake
 - 容器重建后（`/data` 目录丢失）
 - 首次部署时

-## 5. 安装中文字体（手动）
+## 5. 安装中文字体（手动，必须执行）

 QGIS 模板使用了 SimHei（黑体）、SimSun（宋体）、Microsoft YaHei（微软雅黑）等 Windows 中文字体，
 Docker 镜像默认不包含这些字体，会导致中文全部乱码。**字体需手动安装，代码不会自动安装。**

-### 步骤
+### 5.1 准备字体文件
+
+字体文件存放在项目根目录的 `fonts/` 目录下，已预置 4 个常用中文字体：
+
+```
+fonts/
+├── simhei.ttf   — 黑体（模板默认字体）
+├── simsun.ttc   — 宋体
+├── msyh.ttc     — 微软雅黑
+└── msyhbd.ttc   — 微软雅黑粗体
+```
+
+如果字体缺失，从 Windows 主机复制（`C:\Windows\Fonts\`）：

 ```bash
-# 1. 创建字体目录
-docker exec qgis-server mkdir -p /usr/share/fonts/truetype/winfonts
+# Linux 服务器用 SCP 从 Windows 传
+scp "C:\Windows\Fonts\simhei.ttf"  root@服务器IP:/www/wwwroot/xian_algorithm_new/fonts/
+scp "C:\Windows\Fonts\simsun.ttc"  root@服务器IP:/www/wwwroot/xian_algorithm_new/fonts/
+scp "C:\Windows\Fonts\msyh.ttc"    root@服务器IP:/www/wwwroot/xian_algorithm_new/fonts/
+scp "C:\Windows\Fonts\msyhbd.ttc"  root@服务器IP:/www/wwwroot/xian_algorithm_new/fonts/
+```

-# 2. 从主机复制 Windows 中文字体
-#    Windows 路径（根据实际字体文件位置调整）：
-docker cp "C:\Windows\Fonts\simhei.ttf"  qgis-server:/usr/share/fonts/truetype/winfonts/
-docker cp "C:\Windows\Fonts\simsun.ttc"  qgis-server:/usr/share/fonts/truetype/winfonts/
-docker cp "C:\Windows\Fonts\msyh.ttc"    qgis-server:/usr/share/fonts/truetype/winfonts/
-docker cp "C:\Windows\Fonts\msyhbd.ttc"  qgis-server:/usr/share/fonts/truetype/winfonts/
+### 5.2 一键安装到容器

-#    Linux 字体路径示例：
-#    docker cp /usr/share/fonts/truetype/droid/DroidSansFallbackFull.ttf qgis-server:/usr/share/fonts/truetype/winfonts/
+```bash
+python app/script/install_fonts_to_container.py
+```

-# 3. 刷新字体缓存
+输出示例：
+```
+=== 安装中文字体到 Docker 容器 qgis-server ===
+
+  字体目录: /www/wwwroot/xian_algorithm_new/fonts
+  字体文件: 4 个
+    - msyh.ttc (4165 KB)
+    - msyhbd.ttc (4167 KB)
+    - simhei.ttf (2637 KB)
+    - simsun.ttc (10126 KB)
+  容器目标: qgis-server:/usr/share/fonts/truetype/winfonts
+
+  [1/3] 复制字体文件...
+    OK   msyh.ttc
+    OK   msyhbd.ttc
+    OK   simhei.ttf
+    OK   simsun.ttc
+
+  [2/3] 刷新字体缓存...
+    OK
+
+  [3/3] 验证字体...
+    中文字体: ['SimHei', 'SimSun', 'Microsoft YaHei', 'Microsoft YaHei UI']
+
+=== 完成，耗时 3.2s ===
+```
+
+其他用法：
+```bash
+python app/script/install_fonts_to_container.py --dry-run        # 仅查看信息
+python app/script/install_fonts_to_container.py --container my   # 指定容器名
+```
+
+### 5.3 持久化（推荐）
+
+容器重建后字体丢失，**强烈建议挂载 `fonts/` 目录**。
+
+```bash
+# 停掉旧容器
+docker stop qgis-server && docker rm qgis-server
+
+# 重建容器，加上字体挂载
+docker run -d \
+  --name qgis-server \
+  --restart unless-stopped \
+  -v "/www/wwwroot/xian_algorithm_new:/app:ro" \
+  -v "/www/wwwroot/xian_algorithm_new/files:/files" \
+  -v "/www/wwwroot/xian_algorithm_new/fonts:/usr/share/fonts/truetype/winfonts:ro" \
+  qgis/qgis:3.44.11 \
+  sleep infinity
+
+# 挂载后只需刷新一次缓存
 docker exec qgis-server fc-cache -fv
-
-# 4. 验证字体已识别
-docker exec qgis-server python3 -c "
-from PyQt5.QtGui import QFontDatabase
-db = QFontDatabase()
-zh = [f for f in db.families() if 'SimHei' in f or 'YaHei' in f or 'SimSun' in f]
-print('中文字体:', zh)
-"
 ```

-### 持久化方案
+### 5.4 无法获取 Windows 字体时的替代方案

-容器重建后字体丢失。可选方案：
-
-**方案 A：挂载单个字体文件**
 ```bash
-docker run -d ... \
-  -v "C:\Windows\Fonts\simhei.ttf:/usr/share/fonts/truetype/winfonts/simhei.ttf" \
-  -v "C:\Windows\Fonts\simsun.ttc:/usr/share/fonts/truetype/winfonts/simsun.ttc" \
-  ...
-```
+# Linux 服务器安装开源中文字体
+yum install wqy-microhei-fonts    # CentOS / RHEL
+apt install fonts-wqy-microhei    # Debian / Ubuntu

-**方案 B：挂载整个字体目录（推荐）**
-```bash
-# 先在主机创建字体目录，放入所需字体文件
-mkdir -p /opt/qgis-fonts
-cp /usr/share/fonts/truetype/droid/DroidSansFallbackFull.ttf /opt/qgis-fonts/
-
-docker run -d ... \
-  -v "/opt/qgis-fonts:/usr/share/fonts/truetype/winfonts:ro" \
-  ...
+# 将系统字体复制到项目 fonts/ 目录
+cp /usr/share/fonts/wqy-microhei/wqy-microhei.ttc /www/wwwroot/xian_algorithm_new/fonts/
 ```

 ## 6. 验证容器