vimagick/piknik

piknik

镜像概述和主要用途

piknik 是一个通过网络实现任意内容复制粘贴的工具，允许用户在不同设备间通过网络共享剪贴板内容。它通过简单的命令行操作，实现跨网络的内容复制（copy）、粘贴（paste）、移动（move）和删除（delete）功能，适用于需要在多设备间快速共享文本内容的场景。

核心功能和特性

• 跨网络复制粘贴：支持在不同设备间通过网络传输剪贴板内容
• 命令行操作：提供简洁的命令行工具，支持复制、粘贴、移动和删除操作
• 配置文件管理：通过 piknik.toml 文件管理服务器和客户端设置
• 持久化存储：服务器数据可通过卷挂载实现持久化
• 自动重启：支持容器自动重启，确保服务持续可用

使用场景和适用范围

• 多设备间（如本地电脑与远程服务器）的文本内容共享
• 无需依赖第三方服务的私有剪贴板共享
• 命令行环境下的快速内容传输
• 开发和运维工作中跨终端的文本传递

使用方法和配置说明

环境准备

需要安装 Docker 和 Docker Compose。

Docker Compose 配置

创建 docker-compose.yml 文件，内容如下：

yaml
piknik:
  image: vimagick/piknik
  ports:
    - "8075:8075"  # 映射容器端口到主机
  volumes:
    - ./data:/etc/piknik  # 挂载数据卷，用于持久化配置和数据
  restart: unless-stopped  # 除非手动停止，否则自动重启容器

服务器端设置

1. 创建数据目录并生成配置文件：

bash
# 创建数据目录
mkdir -p data

# 创建空配置文件
touch data/piknik.toml

# 生成密钥并写入配置文件
docker-compose run --rm piknik -genkeys > data/piknik.toml

# 编辑配置文件（根据需要调整服务器设置）
vim data/piknik.toml

# 启动服务
docker-compose up -d

说明：piknik.toml 文件包含服务器和客户端的关键配置，包括密钥、端口、超时设置等。

客户端设置

1. 配置客户端别名：

编辑 ~/.bashrc 文件，添加以下别名：

bash
# pkc: 从标准输入读取内容并复制到网络剪贴板
alias pkc='piknik -copy'

# pkp: 粘贴网络剪贴板内容
alias pkp='piknik -paste'

# pkm: 移动网络剪贴板内容（粘贴后清除）
alias pkm='piknik -move'

# pkz: 删除网络剪贴板内容
alias pkz='piknik -copy < /dev/null' 

2. 创建客户端配置文件：

bash
# 编辑客户端配置文件（需与服务器配置匹配，如服务器地址、密钥等）
vim ~/.piknik.toml

# 使别名生效
source ~/.bashrc

使用示例

bash
# 复制内容到网络剪贴板
pkc
hello world  # 输入内容后按 Ctrl+D 结束输入

# 粘贴网络剪贴板内容
pkp
hello world  # 输出结果

# 移动网络剪贴板内容（粘贴后清除）
pkm
hello world  # 输出结果

# 再次移动（此时剪贴板已空）
pkm
The clipboard might be empty  # 输出提示