jonnyan404/cloud-clipboard

cloud-clipboard Docker镜像文档

镜像概述

本镜像基于https://github.com/TransparentLC/cloud-clipboard%E6%89%93%E5%8C%85%EF%BC%8C%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9B%E4%BE%BF%E6%8D%B7%E7%9A%84%E8%B7%A8%E8%AE%BE%E5%A4%87%E5%89%AA%E8%B4%B4%E6%9D%BF%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E3%80%82%E6%94%AF%E6%8C%81amd64%E3%80%81arm64%E3%80%81armv7%E5%A4%9A%E7%A7%8D%E6%9E%B6%E6%9E%84%EF%BC%8C%E5%8F%AF%E5%BF%AB%E9%80%9F%E9%83%A8%E7%BD%B2%E5%B9%B6%E5%AE%9E%E7%8E%B0%E6%96%87%E6%9C%AC%E4%B8%8E%E6%96%87%E4%BB%B6%E7%9A%84%E8%B7%A8%E8%AE%BE%E5%A4%87%E5%85%B1%E4%BA%AB%E3%80%82

变更日志

2025年04月30日

• 移除环境变量ENABLE_MKCERT
• 新增环境变量MANUAL_CERT_PATH和MANUAL_KEY_PATH

2025年04月25日

• 下载链接增加文件名显示

2025年04月19日

1. 集成mkcert用于自签证书
2. 新增环境变量LISTEN_IP6、ENABLE_MKCERT和MKCERT_DOMAIN_OR_IP

核心功能与特性

• 跨设备文本与文件共享
• 支持历史记录管理
• 可配置访问密码保护
• 支持自定义端口与网络监听
• 提供HTTPS支持（自签证书或手动指定证书）
• 支持子路径部署（配合反向代理使用）

使用场景

• 多设备间快速共享文本内容
• 跨平台文件临时传输
• 个人或小型团队内部的轻量级剪贴板同步

使用方法

快速启动

通过以下命令快速部署容器：

bash
docker run -d --name=cloud-clipboard -p 9501:9501 -v /path/your/dir/data:/app/server-node/data jonnyan404/cloud-clipboard

启动后，通过浏览器访问 http://<你的IP>:9501 即可使用。

进阶配置（docker-compose）

创建docker-compose.yml文件，根据需求配置环境变量：

yaml
services:
    cloud-clipboard:
        container_name: cloud-clipboard
        restart: always
        ports:
            - "9501:9501"
        environment:
            - LISTEN_IP6= # 默认为::1，IPv6监听地址，可设置为::（所有IPv6地址），不懂勿动
            - LISTEN_IP= # 默认为0.0.0.0，IPv4监听地址，可设置为127.0.0.1（仅本地访问），不懂勿动
            - LISTEN_PORT= # 默认为9501，自定义监听端口
            - PREFIX= # 子路径，格式如：/cloud-clipboard，用于反向代理场景
            - MESSAGE_NUM= # 历史记录数量，默认为10条
            - AUTH_PASSWORD= # 访问密码，默认为false（关闭密码保护），可设置为自定义字符串
            - TEXT_LIMIT= # 文本长度限制，默认为4096（约2048个汉字），单位为字符
            - FILE_EXPIRE= # 文件过期时间，默认为3600秒（1小时）
            - FILE_LIMIT= # 文件大小限制，默认为104857600字节（100MB）
            - MKCERT_DOMAIN_OR_IP= # mkcert自签证书的域名或IP，多个用空格分隔，仅域名支持通配符*
            - MANUAL_KEY_PATH= # 手动指定证书私钥路径，优先级高于MKCERT_DOMAIN_OR_IP
            - MANUAL_CERT_PATH= # 手动指定证书公钥路径，优先级高于MKCERT_DOMAIN_OR_IP
        volumes:
            - /path/your/dir/data:/app/server-node/data # 数据持久化目录，请替换为实际路径
        image: jonnyan404/cloud-clipboard:latest

启动命令：

bash
docker-compose up -d

环境变量说明