linuxserver/snapdrop

linuxserver/snapdrop Docker镜像文档

弃用通知

该镜像已弃用。我们将不再提供支持，也不会更新此镜像。

建议切换至 https://github.com/linuxserver/docker-pairdrop 以获得类似功能。

镜像概述和主要用途

https://github.com/linuxserver/docker-snapdrop 是基于 https://github.com/snapdrop/snapdrop 项目的Docker镜像。Snapdrop是一个浏览器内的本地文件共享工具，灵感来源于Apple的Airdrop，支持在本地网络中的设备间通过浏览器快速共享文件，无需安装额外软件。

LinuxServer.io团队提供的镜像具有以下特点：

• 定期及时的应用更新
• 简单的用户映射（PGID、PUID）
• 基于s6 overlay的自定义基础镜像
• 每周基础操作系统更新，通过通用层减少空间占用、 downtime和带宽消耗
• 定期安全更新

核心功能和特性

Snapdrop核心功能

• 本地网络设备发现：自动识别同一网络中的其他Snapdrop用户
• 浏览器内文件传输：无需安装客户端，通过网页界面即可发送/接收文件
• 跨平台支持：兼容所有现代浏览器，支持Windows、macOS、Linux及移动设备

LinuxServer.io镜像特性

• 多架构支持：适配x86-64、arm64v8架构
• 持久化配置：通过卷挂载保存配置文件
• 灵活权限管理：支持自定义用户/组ID，避免权限冲突
• 完整的Web服务器配置：内置Nginx，支持HTTP/HTTPS

使用场景和适用范围

• 家庭/办公室本地网络：同一网络内多设备（电脑、手机、平板）间快速共享文件
• 临时文件传输：无需依赖云存储或USB设备，即时传输文档、图片、视频等
• 跨平台协作：不同操作系统设备间（如Windows与macOS）的文件交换
• 无客户端需求场景：在无法安装软件的设备（如公共电脑）上临时共享文件

支持的架构

该镜像利用Docker manifest实现多平台支持，拉取 lscr.io/linuxserver/snapdrop:latest 即可自动获取对应架构的镜像，也可通过标签指定具体架构：

应用设置

Web界面可通过 http://服务器IP:端口 访问。

若仅在本地网络使用，需编辑 /config/nginx/site-confs/default.conf 文件，注释以下行以启用本地发现：

nginx
proxy_set_header X-Forwarded-for $remote_addr;

使用方法和配置说明

Docker Compose（推荐）

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

yaml
---
services:
  snapdrop:
    image: lscr.io/linuxserver/snapdrop:latest
    container_name: snapdrop
    environment:
      - PUID=1000        # 用户ID，详见下方说明
      - PGID=1000        # 组ID，详见下方说明
      - TZ=Etc/UTC       # 时区，如Asia/Shanghai
    volumes:
      - /path/to/snapdrop/config:/config  # 配置文件持久化路径
    ports:
      - 80:80            # HTTP端口映射
      - 443:443          # HTTPS端口映射
    restart: unless-stopped

启动容器：

bash
docker-compose up -d

Docker Run

直接执行命令启动容器：

bash
docker run -d \
  --name=snapdrop \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/snapdrop/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/snapdrop:latest

参数说明

容器运行参数格式为 <外部>:<内部>，以下是支持的参数说明：

环境变量配置

从文件加载环境变量（Docker Secrets）

可通过 FILE__ 前缀从文件加载环境变量，例如：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

上述命令会将 /run/secrets/mysecretvariable 文件内容作为 MYVAR 环境变量的值。

Umask设置

通过 -e UMASK=022 可覆盖容器内服务的默认umask值。umask用于控制新创建文件的权限，具体规则参考 umask说明。

用户/组标识符（PUID/PGID）

使用卷挂载（-v 参数）时，主机与容器可能出现权限冲突。通过指定 PUID（用户ID）和 PGID（组ID），可确保容器内用户与主机用户权限一致。

获取当前用户的PUID和PGID：

bash
id your_user

示例输出：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

其中 uid=1000 即PUID，gid=1000 即PGID。

Docker Mods

可通过Docker Mods扩展容器功能，支持的Mods：

• snapdrop专用Mods
• 通用Mods

支持信息

容器内Shell访问

bash
docker exec -it snapdrop /bin/bash

实时查看日志

bash
docker logs -f snapdrop

查看容器版本

bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' snapdrop

查看镜像版本

bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/snapdrop:latest

更新说明

通过Docker Compose更新

1. 更新镜像：

   bash
   # 更新所有镜像
   docker-compose pull
   # 仅更新snapdrop
   docker-compose pull snapdrop
   

2. 重启容器：

   bash
   # 重启所有容器
   docker-compose up -d
   # 仅重启snapdrop
   docker-compose up -d snapdrop
   

3. 清理旧镜像：

   bash
   docker image prune
   

通过Docker Run更新

1. 拉取最新镜像：

   bash
   docker pull lscr.io/linuxserver/snapdrop:latest
   

2. 停止并删除当前容器：

   bash
   docker stop snapdrop
   docker rm snapdrop
   

3. 使用原参数重新创建容器（配置通过 /config 卷保留）

4. 清理旧镜像：

   bash
   docker image prune
   

镜像更新通知 - Diun

推荐使用 Diun 监控镜像更新，不建议使用自动更新工具。

本地构建

如需自定义镜像，可本地构建：

bash
git clone https://github.com/linuxserver/docker-snapdrop.git
cd docker-snapdrop
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/snapdrop:latest .

跨架构构建（如x86_64构建ARM镜像）：

bash
# 注册qemu-static
docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
# 构建特定架构（如arm64v8）
docker build -f Dockerfile.aarch64 -t lscr.io/linuxserver/snapdrop:arm64v8-latest .

版本历史

• 19.02.25: 弃用镜像
• 31.05.24: 基于Alpine 3.20重建，用户需更新nginx配置以避免http2弃用警告
• 06.02.24: 清理默认站点配置，现有用户需更新 /config/nginx/site-confs/default.conf
• 23.12.23: 基于Alpine 3.19和PHP 8.3重建
• 25.05.23: 基于Alpine 3.18重建，弃用armhf架构
• 13.04.23: 将ssl.conf包含移至default.conf
• 20.01.23: 基于Alpine 3.17和PHP 8.1重建
• 20.08.22: 基于Alpine 3.15和PHP 8重建，重构nginx配置
• 09.08.21: 基于Alpine 3.14重建，添加real_ip块到nginx配置
• 15.09.20: 初始发布