jonnyan404/cloud-clipboard Docker 镜像 - 轩辕镜像

cloud-clipboard Docker镜像文档

镜像概述

本镜像基于cloud-clipboard项目打包，旨在提供便捷的跨设备剪贴板解决方案。支持amd64、arm64、armv7多种架构，可快速部署并实现文本与文件的跨设备共享。

变更日志

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= # 文件大小限制，默认为***字节（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

环境变量说明