通过 Docker Compose 部署 libreoffice/online

## 目录和文件结构

确保项目目录结构如下：

```
your_project_dir/
├── collabora/
│   ├── config/
│   ├── logs/
│   └── data/
├── docker-compose.yml
└── nginx/
    ├── conf.d/
    │   ├── default.conf
    │   └── redirect.conf
    └── .htpasswd
    └── ssl/
        ├── nginx.crt
        └── nginx.key
```

## 1. 创建 Docker Compose 配置文件

在项目根目录下创建 `docker-compose.yml` 文件，定义 Collabora 和 Nginx 服务，并将 Collabora 的一些关键目录映射到宿主机：

```yaml
#version: '3.3'
services:
  collabora:
    image: collabora/code:latest
    container_name: collabora
    environment:
      - domain=localhost   # 必须，替换为您需要的域名或 IP 地址
      - dictionaries=zh_CN # 设置默认语言为中文
    cap_add:
      - MKNOD
    ports:
      - 9980:9980
    volumes:
      - ./collabora/config:/etc/loolwsd
      - ./collabora/logs:/var/log/loolwsd
      - ./collabora/data:/var/lib/loolwsd
    restart: always
    networks:
      - collabora_network

nginx:
    image: nginx:latest
    container_name: nginx
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d
      - ./nginx/.htpasswd:/etc/nginx/.htpasswd
      - ./nginx/ssl:/etc/nginx/ssl
    ports:
      - 80:80
      - 443:443
    depends_on:
      - collabora
    networks:
      - collabora_network

networks:
  collabora_network:
```

## 2. 创建 Nginx 配置文件

### 2.1 创建 `default.conf` 文件

在 `nginx/conf.d/` 目录下创建 `default.conf` 文件，配置 Nginx 作为反向代理并启用基本认证，为 HTTPS 配置：

```nginx
server {
    listen 443 ssl;
    server_name localhost;

ssl_certificate /etc/nginx/ssl/nginx.crt;
    ssl_certificate_key /etc/nginx/ssl/nginx.key;

location / {
        proxy_pass http://collabora:9980;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Accept-Encoding gzip;

auth_basic "Restricted Content";
        auth_basic_user_file /etc/nginx/.htpasswd;
    }
}
```

### 2.2 创建 `redirect.conf` 文件

在 `nginx/conf.d/` 目录下创建 `redirect.conf` 文件，将 HTTP 请求重定向到 HTTPS：

```nginx
server {
    listen 80;
    server_name localhost;

location / {
        return 301 https://$host$request_uri;
    }
}
```

## 3. 创建 `.htpasswd` 文件

使用 `htpasswd` 工具生成 `.htpasswd` 文件，添加多个用户账号：

```sh
# 在项目目录下执行（创建并添加第一个用户）
htpasswd -c ./nginx/.htpasswd user1
# 添加其他用户
htpasswd -b ./nginx/.htpasswd user2 password2
htpasswd -b ./nginx/.htpasswd user3 password3
```

你可以根据需要添加更多用户。

## 4. 创建 SSL 证书

创建用于 Nginx 的 SSL 证书和密钥。如果使用自签名证书，可以使用以下命令生成：

```sh
mkdir -p nginx/ssl
openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
    -keyout nginx/ssl/nginx.key \
    -out nginx/ssl/nginx.crt \
    -subj "/CN=localhost"
```

## 5. 启动 Docker Compose 服务

在项目根目录下执行以下命令启动服务：

```sh
docker compose up -d
```

## 6. 访问 LibreOffice Online 服务

通过浏览器访问 `http://localhost` 进行测试，会发现它会自动重定向到 `https://localhost`。系统将提示输入用户名和密码，并使用 `.htpasswd` 文件中的用户名和密码进行验证。

## 切换用户的方式

用户可以通过以下几种方式切换账号：

### A. 清除浏览器缓存

1. 打开浏览器设置（例如 Chrome 的三个点菜单按钮）
2. 选择“更多工具” -> “清除浏览数据”
3. 选择要清除的内容（例如 Cookie 和其他网站数据）
4. 点击“清除数据”

### B. 使用私人/无痕窗口

用户可以在私人/无痕浏览模式中打开新会话：

- 在 Chrome 中，点击右上角菜单按钮，选择“新建无痕模式窗口”
- 在 Firefox 中，点击右上角菜单按钮，选择“新建隐私窗口”

### C. 直接在 URL 中输入账号

在地址栏输入 `https://username:password@localhost`，例如：

```url
https://user2:password2@localhost
```

这种方法可能会有安全限制，因此不建议使用。

## 注意事项

1. **日志检查**：启动 Docker Compose 服务后，可以通过以下命令检查 Collabora 和 Nginx 的日志，以确保服务正常运行：
    ```sh
    docker logs collabora
    docker logs nginx
    ```
2. **端口号**：确保在 Docker Compose 和 Nginx 配置文件中使用的端口号没有被其他服务占用。
3. **SSL 证书**：如果使用的是自签名证书，浏览器会提示安全警告，需要手动信任该证书。

## Collabora Online 镜像说明

`collabora/code:latest` 是 Collabora Office 发布的官方 Docker 镜像，用于运行 Collabora Online Development Edition (CODE)。Collabora Online 是专为云端与浏览器设计的在线文档编辑解决方案，基于 LibreOffice 构建，并实现了在 Web 环境中使用的功能。

### Collabora Online 的特性

- **浏览器中的文档编辑**：允许用户在浏览器中实时编辑文档。
- **丰富的文档兼容性**：支持多种文档格式，包括 ODF、DOCX、XLSX、PPTX 等。
- **实时协作**：多个用户可以同时编辑同一个文档，并可以实时看到其他用户所做的修改。
- **强大的安全特性**：支持通过 HTTPS 加密访问，并集成多种身份验证方式。

通过这些步骤，你可以成功部署和运行 Nginx 保护的多用户 Collabora Online 服务。如果有任何问题或需要进一步帮助，请随时告知！