Docker-PairDrop(局域网传输)

[PairDrop](https://github.com/schlagmichdoch/pairdrop) 跨平台传输文件，无需设置，无需注册
同 [Snapdrop](/doc/480/) 功能类似，并且增加了公共房间可以跨局域网传输(需配置 STUN/TURN)

**相关链接：**
- Demo(在线使用)：https://pairdrop.net/#
- GitHub：https://github.com/schlagmichdoch/pairdrop
  - 单 PairDrop：https://github.com/schlagmichdoch/PairDrop/blob/master/docker-compose.yml
  - Nginx反代：https://github.com/schlagmichdoch/PairDrop/blob/master/docker-compose-dev.yml
  - Coturn：https://github.com/schlagmichdoch/PairDrop/blob/master/docker-compose-coturn.yml
    - turnserver配置：https://github.com/schlagmichdoch/PairDrop/blob/master/turnserver_example.conf
    - rtc_config配置：https://github.com/schlagmichdoch/PairDrop/blob/master/rtc_config_example.json
- Docker：https://hub.docker.com/r/linuxserver/pairdrop
- 部署说明：https://github.com/schlagmichdoch/PairDrop/blob/master/docs/host-your-own.md

STUN/TURN(Coturn) 部署较为繁琐，问题较多，若是只是需要局域网使用则无需部署 STUN/TURN，若是需要异地使用则需要

## Docker 部署
```bash
# 快速部署(仅支持局域网)
docker run -d --name=pairdrop -p 3000:3000 linuxserver/pairdrop
```

## docker-compose 部署
```bash
# 仅支持局域网
nano docker-compose.yml  # 创建 docker-compose.yml 配置文件
docker-compose up -d  # 拉取并部署
```
`docker-compose.yml`，根据实际情况调整
```bash
services:
  pairdrop:
    container_name: pairdrop  # 自定义容器名称
    image: linuxserver/pairdrop  # dockerhub 源
    # image: lscr.io/linuxserver/pairdrop  # lscr.io 源
    # image: ghcr.io/schlagmichdoch/pairdrop  # ghcr.io 源
    restart: unless-stopped  # 除非停止,否则一直运行
    ports:
      - 3000:3000  # Web UI⭐
    # volumes:
    #   - ./rtc_config.json:/rtc_config.json  # STUN/TURN 配置文件(跨网络分享需要)
    environment:
      # - PUID=1000  # 运行应用程序的 UID
      # - PGID=1000  # 运行应用程序的 GID
      - WS_FALLBACK=true  # 如果客户端无法通过点对点 WebRTC 连接来使用包含 Websocket 回退的客户端提供 PairDrop
      - RATE_LIMIT=false  # 会限制客户端每5分钟发送1000个请求
      - TZ=Asia/shanghai  # 时区
      # - RTC_CONFIG=/rtc_config.json  # STUN/TURN 配置json 文件(跨网络分享需要)
      # - DEBUG_MODE=false  # 调试模式
      # =============================== PairDrop 页面的可自定义按钮 ===============================
      - DONATION_BUTTON_ACTIVE=false  # 显示捐赠按钮
      - TWITTER_BUTTON_ACTIVE=false  # 显示 Twitter 按钮
      - MASTODON_BUTTON_ACTIVE=false  # 显示 Mastodon 按钮
      - BLUESKY_BUTTON_ACTIVE=false  # 显示 Bluesky 按钮
      # - CUSTOM_BUTTON_ACTIVE=false  # 显示自定义按钮
      - PRIVACYPOLICY_BUTTON_ACTIVE=false  # 显示隐私政策按钮
      # - DONATION_BUTTON_LINK=https://www.buymeacoffee.com/pairdrop  # 捐赠按钮链接
      # - TWITTER_BUTTON_LINK=https://twitter.com/account  # Twitter 按钮链接
      # - MASTODON_BUTTON_LINK=https://mastodon.social/account  # Mastodon 按钮链接
      # - BLUESKY_BUTTON_LINK=https://bsky.app/profile/account  # Bluesky 按钮链接
      - CUSTOM_BUTTON_LINK=https://nas.918178.xyz:10086  # 自定义按钮链接
      # - PRIVACYPOLICY_BUTTON_LINK=https://link-to-your-privacy-policy.net  # 隐私政策按钮链接
      # - DONATION_BUTTON_TITLE="给我买杯咖啡"  # 捐赠按钮标题
      # - TWITTER_BUTTON_TITLE="在 Twitter 上找到我"  # Twitter 按钮标题
      # - MASTODON_BUTTON_TITLE="在 Mastodon 上找到我"  # Mastodon 按钮标题
      # - BLUESKY_BUTTON_TITLE="在 Bluesky 上找到我"  # Bluesky 按钮标题
      - CUSTOM_BUTTON_TITLE="造物者W"  # 自定义按钮标题
      # - PRIVACYPOLICY_BUTTON_TITLE="打开我们的隐私政策"  # 隐私政策按钮标题
    # networks:  # 加入Nginx网络反代使用
    #   #- default  # 默认的网络(也可仅加入nginx网络)
    #   - nginxui_default  # 连接网络名称(也可仅把需要反向代理的额外加入nginx)

# # 加入nginx容器所在网络(否则无法使用nginx代理)
# networks:  # 该项和 services 同级(顶格)
#   nginxui_default:  # 连接网络名称
#     external: true  # 加入网络
#     name: nginxui_default  # 网络的名称
```

## 含 STUN/TURN 部署
VPS服务器 和 PXE+Debian12 上测试正常(局域网正常，异地间不显示，加房间和配对后正常显示)
但是使用 群晖 部署会有问题(异地显示 和 加房间和配对后也不显示 都遇到过)
目前发现问题主要是 PairDrop 对客户端IP解析的问题，无法获取到客户端正确的内部IP

STUN/TURN 详细可参考 [Docker-STUN/TURN(Coturn)](/doc/988/#h2-docker-composeu90E8u7F72)
```bash
nano docker-compose.yml  # 编写 docker-compose.yml 配置
nano rtc_config.json  # 编写 PairDrop STUN/TURN 配置
nano turnserver.conf  # 编写 STUN/TURN(Coturn) 配置
nano nginx.conf  # 编写 Nginx 配置
docker-compose up -d  # 拉取并部署
```
`docker-compose.yml`，按需修改
```yaml
services:
  pairdrop:
    container_name: pairdrop  # 自定义容器名称
    image: linuxserver/pairdrop  # dockerhub 源
    # image: lscr.io/linuxserver/pairdrop  # lscr.io 源
    # image: ghcr.io/schlagmichdoch/pairdrop  # ghcr.io 源
    restart: unless-stopped  # 除非停止,否则一直运行
    # network_mode: host  # 使用host模式，无需映射端口
    # ports:
    #   - 3000:3000  # Web UI
    volumes:
      - ./rtc_config.json:/rtc_config.json  # STUN/TURN 配置文件(跨网络分享需要)
    environment:
      - PUID=1000  # 运行应用程序的 UID
      - PGID=1000  # 运行应用程序的 GID
      # - WS_FALLBACK=true  # 如果客户端无法通过点对点 WebRTC 连接来使用包含 Websocket 回退的客户端提供 PairDrop
      # - RATE_LIMIT=false  # 会限制客户端每5分钟发送1000个请求
      - TZ=Asia/shanghai  # 时区
      - RTC_CONFIG=/rtc_config.json  # STUN/TURN 配置json 文件(跨网络分享需要)
      # - DEBUG_MODE=true  # 调试模式
      # =============================== PairDrop 页面的可自定义按钮 ===============================
      - DONATION_BUTTON_ACTIVE=false  # 显示捐赠按钮
      - TWITTER_BUTTON_ACTIVE=false  # 显示 Twitter 按钮
      - MASTODON_BUTTON_ACTIVE=false  # 显示 Mastodon 按钮
      - BLUESKY_BUTTON_ACTIVE=false  # 显示 Bluesky 按钮
      # - CUSTOM_BUTTON_ACTIVE=false  # 显示自定义按钮
      - PRIVACYPOLICY_BUTTON_ACTIVE=false  # 显示隐私政策按钮
      # - DONATION_BUTTON_LINK=https://www.buymeacoffee.com/pairdrop  # 捐赠按钮链接
      # - TWITTER_BUTTON_LINK=https://twitter.com/account  # Twitter 按钮链接
      # - MASTODON_BUTTON_LINK=https://mastodon.social/account  # Mastodon 按钮链接
      # - BLUESKY_BUTTON_LINK=https://bsky.app/profile/account  # Bluesky 按钮链接
      - CUSTOM_BUTTON_LINK=https://nas.918178.xyz:10086  # 自定义按钮链接
      # - PRIVACYPOLICY_BUTTON_LINK=https://link-to-your-privacy-policy.net  # 隐私政策按钮链接
      # - DONATION_BUTTON_TITLE="给我买杯咖啡"  # 捐赠按钮标题
      # - TWITTER_BUTTON_TITLE="在 Twitter 上找到我"  # Twitter 按钮标题
      # - MASTODON_BUTTON_TITLE="在 Mastodon 上找到我"  # Mastodon 按钮标题
      # - BLUESKY_BUTTON_TITLE="在 Bluesky 上找到我"  # Bluesky 按钮标题
      - CUSTOM_BUTTON_TITLE="造物者W"  # 自定义按钮标题
    depends_on:  # 等待其他基础服务启动后启动
      - coturn_server

coturn_server:  # Coturn服务器(STUN/TURN 服务)
    container_name: coturn  # 自定义容器名称
    image: coturn/coturn:alpine  # alpine 轻量
    restart: unless-stopped  # 除非停止,否则一直运行
    # network_mode: host  # 使用host模式，无需映射端口
    ports:
      - 3478:3478  # 主监听端口⭐
      - 3478:3478/udp  # 主监听端口⭐
      - 5349:5349  # TLS端口⭐
      - 5349:5349/udp  # TLS端口⭐
      - 55000-55100:55000-55100/udp  # 客户端分配端口范围⭐
    volumes:
      - ./turnserver.conf:/etc/coturn/turnserver.conf  # Coturn配置文件
      - ./ssl:/etc/coturn/ssl/  # SSL证书

nginx:  # Nginx 反代
    container_name: nginx  # 自定义容器名称
    image: nginx
    restart: unless-stopped  # 除非停止,否则一直运行
    ports:
      - 3000:3000  # 对外开放端口⭐
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf  # Nginx 配置文件
      - ./ssl:/etc/ssl/certs/  # SSL 证书
    depends_on:  # 等待其他基础服务启动后启动
      - coturn_server
      - pairdrop
```
`turnserver.conf`，PairDrop 配置
```bash
# TURN 服务器域(随意)⭐
realm=nas.918178.xyz
# TURN 服务器名称(随意)
server-name=coturn

# TURN服务器的外部IP地址,如果Coturn位于NAT后面则需要配置
# external-ip=x.x.x.x
# TURN服务器监听的IP地址,0.0.0.0全部监听⭐
listening-ip=0.0.0.0
# 主端口用于STUN和TURN(根据实际情况修改),开放TCP/UDP⭐
listening-port=3478
# TLS加密的TURN(TURNS)(根据实际情况修改),开放TCP/UDP⭐
tls-listening-port=5349
# 其他开放的通信端口范围(根据实际情况修改),开放UDP⭐
min-port=55000
max-port=55100

# 指定 TURN 认证的用户(用户名:密码)⭐
user=zwzw:zwzw

# 启用指纹
fingerprint
# 启用长期凭据机制
lt-cred-mech
# 启用详细日志记录
# verbose
# 日志文件路径，- 输出至 STDOUT，容器日志中可查看
log-file=-

# SSL 证书，⭐按需更改
cert=/etc/coturn/ssl/<证书>.cer
pkey=/etc/coturn/ssl/<密钥>.key
# 命令生成(时间较长) openssl dhparam -out ./ssl/dhparams.pem 4096
# dh-file=/etc/coturn/ssl/dhparam.pem

# 为了安全起见，禁用旧的 ssl 和 tls 协议
# 其他推荐选项：https://github.com/coturn/coturn/blob/master/examples/etc/turnserver.conf
no-sslv3
no-tlsv1
no-tlsv1_1
no-tlsv1_2
no-rfc5780
no-stun-backward-compatibility
response-origin-only-with-rfc5780
no-cli
no-multicast-peers
no-software-attribute
check-origin-consistency
```
`rtc_config.json`，连接你的 STUN/TURN(不部署则异地无法使用)
优先使用 STUN打洞(客户端间直连)，打洞识别才会使用 TURN中继转发(客户端经过服务器转发)，中继转发时就会需要用到额外开放的端口了
- STUN：TLS地址前缀也一样，并且不需要用户名密码
不区分协议，两个端口上都正常跑
- TURN,TURNS(TLS)：可以配置用户名和密码
两个端口区分协议

```bash
{
  "sdpSemantics": "unified-plan",
  "iceServers": [
    {
      "urls": "stun:xx.918178.xyz:3478"
    },
    {
      "urls": "turn:xx.918178.xyz:3478",
      "username": "zwzw",
      "credential": "zwzw"
    },
    {
      "urls": "stun:xx.918178.xyz:5349"
    },
    {
      "urls": "turns:xx.918178.xyz:5349",
      "username": "zwzw",
      "credential": "zwzw"
    }
  ]
}
```
`nginx.conf`，反向代理(可选)
```bash
user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;
events {
  worker_connections 1024;
}
http {
  include mime.types;
  charset UTF-8;
  server {
    listen 3000 ssl;  # ⭐监听端口,按需更改
    server_name _;  # 监听域名
    ssl_certificate /etc/ssl/certs/fullchain.pem;  # ⭐证书,按需更改
    ssl_certificate_key /etc/ssl/certs/privkey.pem;  # ⭐密钥,按需更改
    error_page 497 =307 https://$host:$server_port$request_uri;  # http自动转https
    expires epoch;  # 过期时间
    location / {
      proxy_connect_timeout 300;
      proxy_pass http://pairdrop:3000;  # ⭐连接内部容器,按需更改
      proxy_set_header Connection "upgrade";
      proxy_set_header Upgrade $http_upgrade;
      proxy_set_header X-Forwarded-for $remote_addr;
    }
  }
}
```