linuxserver/snapdrop Docker Image Overview

linuxserver/snapdrop

linuxserver

提供Snapdrop服务，支持设备间通过浏览器快速、安全地共享文件的Docker镜像。

84 收藏0 次下载

😅 镜像要是出问题，背锅的一定是你

中文简介版本下载

😅 镜像要是出问题，背锅的一定是你

linuxserver/snapdrop Docker镜像文档

弃用通知

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

建议切换至 linuxserver/docker-pairdrop 以获得类似功能。

镜像概述和主要用途

linuxserver/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 即可自动获取对应架构的镜像，也可通过标签指定具体架构：

架构	支持情况	标签
x86-64	✅	amd64-<version tag>
arm64	✅	arm64v8-<version tag>
armhf	❌	-

应用设置

Web界面可通过 [***] 访问。

若仅在本地网络使用，需编辑 /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

参数说明

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

参数	功能
`-p 80:80`	HTTP Web界面端口映射
`-p 443:443`	HTTPS Web界面端口映射
`-e PUID=1000`	运行应用的用户ID，避免权限问题
`-e PGID=1000`	运行应用的组ID，避免权限问题
`-e TZ=Etc/UTC`	指定时区，可选值参考时区列表
`-v /config`	配置文件持久化目录，存储Nginx配置等

环境变量配置

从文件加载环境变量（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更新

更新镜像：

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

重启容器：

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

清理旧镜像：

bash
docker image prune

通过Docker Run更新

拉取最新镜像：

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

停止并删除当前容器：

bash
docker stop snapdrop
docker rm snapdrop

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

清理旧镜像：

bash
docker image prune

镜像更新通知 - Diun

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

本地构建

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

bash
git clone [***]
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 .