以下是实现Alist与Collabora Online集成，实现在线预览PDF和Office文件的详细方案：
---
### **一、部署Collabora Online**
1. **使用Docker运行Collabora容器**
```bash
docker run -t -d -p 9980:9980 \
-e "domain=your-alist-domain.com" \
-e "username=admin" \
-e "password=secure_password" \
--restart always \
--cap-add MKNOD \
collabora/code
```
- **参数说明**：
- `domain`: 替换为Alist的域名（或IP，若用IP需加`\<your_IP\>`）。
- `username/password`: 设置Collabora管理账号。
2. **验证Collabora运行状态**
访问 `http://服务器IP:9980`，应显示“OK”状态。
---
### **二、配置反向代理（Nginx）**
1. **为Collabora配置HTTPS代理**
```nginx
server {
listen 443 ssl;
server_name collabora.your-domain.com;
ssl_certificate /path/to/fullchain.pem;
ssl_certificate_key /path/to/privkey.key;
location / {
proxy_pass http://localhost:9980;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
```
- 重启Nginx：`systemctl restart nginx`
2. **可选：为Alist配置代理（若需HTTPS）**
```nginx
server {
listen 443 ssl;
server_name alist.your-domain.com;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;
location / {
proxy_pass http://localhost:15244;
proxy_set_header Host $host;
}
}
```
---
### **三、配置Alist生成Collabora预览链接**
1. **修改Alist预览模板**
- 编辑Alist的`templates/预览模板.html`（具体路径取决于Alist版本），添加以下内容：
```html
<iframe src="https://collabora.your-domain.com/loleaflet/3155/loleaflet.html?file_url=文件直链URL"
width="100%"
height="600px"
allowfullscreen>
</iframe>
```
- **动态文件URL处理**：
- 使用Alist的API获取文件直链，替换`文件直链URL`为实际值（需URL编码）。
2. **通过存储策略自动生成链接**
- 在Alist的存储配置中，自定义预览URL格式：
```
https://collabora.your-domain.com/loleaflet/3155/loleaflet.html?file_url={文件直链}
```
---
### **四、文件访问权限配置**
1. **确保Collabora可访问文件**
- **本地存储**：将Alist的文件目录映射到Collabora容器中（需修改Docker命令添加`-v /path/to/alist/data:/alist-data`）。
- **远程存储**：确保文件直链无需认证即可访问（或配置Collabora使用Alist的API Token）。
2. **跨域配置（CORS）**
- 在Alist的服务器配置中添加Collabora域到CORS允许列表：
```http
Access-Control-Allow-Origin: https://collabora.your-domain.com
```
---
### **五、验证与测试**
1. **上传测试文件**
- 通过Alist上传PDF或Office文件（如test.docx）。
2. **触发预览**
- 在Alist文件列表中找到测试文件，点击“预览”按钮。
- 预期行为：在新窗口或iframe中加载Collabora界面并显示文档内容。
3. **故障排查**
- **空白页面**：检查浏览器控制台是否有CORS错误，调整Nginx或Alist的CORS设置。
- **文件无法加载**：确保文件直链可公开访问，且Collabora容器能解析Alist域名。
---
### **六、高级优化**
1. **HTTPS强制跳转**
```nginx
server {
listen 80;
server_name collabora.your-domain.com;
return 301 https://$host$request_uri;
}
```
2. **缓存优化**
- 在Nginx中为Collabora添加静态资源缓存：
```nginx
location ~* \.(js|css|png)$ {
expires 30d;
add_header Cache-Control "public";
}
```
---
### **七、最终效果**
- 用户通过Alist上传文件后，可直接在浏览器中预览，无需下载。
- 支持格式：DOCX、PPTX、XLSX、PDF等（完整列表参考[Collabora官方文档](https://www.collaboraoffice.com/)）。
---
**注意事项**：
1. 若使用IP而非域名，需在Collabora的`domain`参数中添加`\<IP\>`（如`domain=your-alist-domain.com\|192.168.1.100`）。
2. 文件较大时预览加载较慢，建议调整Collabora的`client_max_body_size`（Nginx）和超时设置。
文章评论