使用 Docker Compose 部署 fontInAss 字幕字体处理服务

1
原始 ASS 字幕（100KB）
2
├─ 字幕文本: "这是中文字幕"
3
└─ 字体声明: Font: 思源黑体 CN Bold
4

5
         ↓ fontInAss 处理流程
6

7
1. 拦截字幕请求
8
2. 分析字幕使用的所有字符
9
3. 从字体库提取对应字形
10
4. 压缩字体（10MB → 50KB）
11
5. UUEncode 编码并嵌入字幕
12

13
         ↓
14

15
处理后的 ASS 字幕（150KB）
16
├─ 字幕文本: "这是中文字幕"
17
├─ 字体声明: Font: 思源黑体 CN Bold
18
└─ [Fonts] 段: <嵌入的字体数据>

1
# 上游服务器配置
2
upstream fontinass_backend {
3
    server 127.0.0.1:8011;
4
    keepalive 32;
5
}
6

7
upstream emby_backend {
8
    server 127.0.0.1:8096;
9
    keepalive 32;
10
}
11

12
# HTTP 重定向到 HTTPS
13
server {
14
    listen 80;
15
    listen [::]:80;
16
    server_name your-domain.com;
17

18
    # 重定向所有HTTP请求到HTTPS
19
    return 301 https://$host$request_uri;
20
}
21

22
# HTTPS 主配置
23
server {
24
    listen 443 ssl;
25
    listen [::]:443 ssl;
26
    http2 on;
27
    server_name your-domain.com;
28

29
    # SSL 证书配置
30
    ssl_certificate /path/to/cert.pem;
31
    ssl_certificate_key /path/to/key.pem;
32

33
    # SSL 优化配置
34
    ssl_protocols TLSv1.2 TLSv1.3;
35
    ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';
36
    ssl_prefer_server_ciphers on;
37
    ssl_session_cache shared:SSL:10m;
38
    ssl_session_timeout 10m;
39

40
    # 安全头
41
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
42
    add_header X-Content-Type-Options "nosniff" always;
43
    add_header X-Frame-Options "SAMEORIGIN" always;
44

45
    # 日志
46
    access_log /var/log/nginx/fontinass.access.log;
47
    error_log /var/log/nginx/fontinass.error.log;
48

49
    # 客户端上传大小限制
50
    client_max_body_size 100M;
51

52
    # WebSocket 支持（直接转发到 Emby）
53
    location ~ /(socket|embywebsocket) {
54
        proxy_pass http://emby_backend;
55
        proxy_http_version 1.1;
56
        proxy_set_header Upgrade $http_upgrade;
57
        proxy_set_header Connection "upgrade";
58
        proxy_set_header Host $host;
59
        proxy_set_header X-Real-IP $remote_addr;
60
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
61
        proxy_set_header X-Forwarded-Proto $scheme;
62
        proxy_read_timeout 86400;
63
    }
64

65
    # 字幕文件拦截（转发到 fontInAss 处理）
66
    location ~* /videos/(.*)/Subtitles/(.*)/(Stream\.ass|Stream\.ssa|Stream\.srt|Stream\.)$ {
67
        proxy_pass http://fontinass_backend;
68
        proxy_http_version 1.1;
69
        proxy_set_header Host $host;
70
        proxy_set_header X-Real-IP $remote_addr;
71
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
72
        proxy_set_header X-Forwarded-Proto $scheme;
73
        proxy_read_timeout 300;
74
        proxy_connect_timeout 75;
75

76
        # Gzip 压缩（针对字幕文件）
77
        gzip on;
78
        gzip_comp_level 6;
79
        gzip_types text/x-ssa text/plain application/x-subrip;
80
    }
81

82
    # 飞牛/Jellyfin 字幕 API（转发到 fontInAss）
83
    location ~ /v/api/v1/subtitle/dl/(.*) {
84
        proxy_pass http://fontinass_backend;
85
        proxy_http_version 1.1;
86
        proxy_set_header Host $host;
87
        proxy_set_header X-Real-IP $remote_addr;
88
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
89
        proxy_set_header X-Forwarded-Proto $scheme;
90
    }
91

92
    # JS 文件修改（Web 端字体渲染支持）
93
    location ~ /web/modules/htmlvideoplayer/plugin\.js {
94
        proxy_pass http://fontinass_backend;
95
        proxy_http_version 1.1;
96
        proxy_set_header Host $host;
97
        proxy_set_header X-Real-IP $remote_addr;
98
        proxy_cache_bypass 1;
99
        add_header Content-Type "application/javascript" always;
100
    }
101

102
    location ~ /web/bower_components/(.*)/subtitles-octopus\.js {
103
        proxy_pass http://fontinass_backend;
104
        proxy_http_version 1.1;
105
        proxy_set_header Host $host;
106
        proxy_set_header X-Real-IP $remote_addr;
107
        proxy_cache_bypass 1;
108
        add_header Content-Type "application/javascript" always;
109
    }
110

111
    # fontInAss Web UI 和 API
112
    location ~ ^/(subset|api|color|fontinass)/ {
113
        proxy_pass http://fontinass_backend;
114
        proxy_http_version 1.1;
115
        proxy_set_header Host $host;
116
        proxy_set_header X-Real-IP $remote_addr;
117
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
118
        proxy_set_header X-Forwarded-Proto $scheme;
119
    }
120

121
    # 默认转发到 Emby 服务器
122
    location / {
123
        proxy_pass http://emby_backend;
124
        proxy_http_version 1.1;
125
        proxy_set_header Host $host;
126
        proxy_set_header X-Real-IP $remote_addr;
127
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
128
        proxy_set_header X-Forwarded-Proto $scheme;
129
        proxy_set_header X-Forwarded-Host $host;
130

131
        # 缓冲配置
132
        proxy_buffering off;
133
        proxy_redirect off;
134
    }
135
}

1
1. watchdog 实时监控 /fonts 目录
2
2. 发现新字体 → 提取元信息
3
   - 字体族名（familyName）
4
   - 完整名称（fullName）
5
   - PostScript 名称
6
   - 粗细（weight）
7
   - 样式（bold/italic）
8
3. 添加到 SQLite 数据库
9
4. 立即可用（无需重启容器）

1
https://your-domain.com/subset/

1
1. 访问 Web UI
2
2. 上传字幕文件（支持拖拽）
3
3. 等待处理（通常几秒钟）
4
4. 下载带字体的字幕文件
5
5. 替换原字幕使用

1
# 在 http 块中添加
2
proxy_cache_path /var/cache/nginx/fontinass levels=1:2 keys_zone=fontinass_cache:10m max_size=1g inactive=60m;
3

4
# 在 location ~ /videos/.*/Subtitles/ 块中添加
5
proxy_cache fontinass_cache;
6
proxy_cache_valid 200 60m;
7
proxy_cache_key "$scheme$request_method$host$request_uri";