linuxserver/filezilla 镜像文档

镜像概述和主要用途

FileZilla 客户端是一款快速可靠的跨平台FTP、FTPS和SFTP客户端，具有丰富的实用功能和直观的图形用户界面。linuxserver/filezilla镜像将FileZilla客户端封装为Docker容器，通过Web界面提供访问能力，适用于需要通过浏览器管理文件传输连接的场景。

核心功能和特性

• 定期应用更新：及时更新FileZilla客户端至最新版本
• 灵活用户映射：支持通过PUID/PGID参数配置容器内用户权限
• 自定义基础镜像：基于s6 overlay构建，提供稳定的进程管理
• 高效系统更新：每周基础系统更新，通过共享层减少存储空间占用、 downtime和带宽消耗
• 安全更新保障：定期进行安全补丁更新

支持的架构

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

使用场景和适用范围

• 需通过Web界面管理FTP/SFTP连接的用户
• 本地网络环境中需要临时文件传输客户端的场景
• 开发/测试环境中快速部署FileZilla客户端
• 需在无本地桌面环境的服务器上使用图形化FTP工具的场景

注意：不建议直接暴露到互联网，需配合反向代理及强认证机制使用。

详细的使用方法和配置说明

部署示例

Docker Compose (推荐)

yaml
---
services:
  filezilla:
    image: lscr.io/linuxserver/filezilla:latest
    container_name: filezilla
    environment:
      - PUID=1000        # 用户ID，详见下方用户/组ID说明
      - PGID=1000        # 组ID，详见下方用户/组ID说明
      - TZ=Etc/UTC       # 时区，如Asia/Shanghai
    volumes:
      - /path/to/config:/config  # 配置文件存储路径
    ports:
      - 3000:3000        # HTTP端口(需代理)
      - 3001:3001        # HTTPS端口(推荐直接使用)
    shm_size: "1gb"      # 共享内存大小，桌面应用推荐设置
    restart: unless-stopped

Docker Run

bash
docker run -d \
  --name=filezilla \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 3000:3000 \
  -p 3001:3001 \
  -v /path/to/config:/config \
  --shm-size="1gb" \
  --restart unless-stopped \
  lscr.io/linuxserver/filezilla:latest

参数说明

应用访问

应用访问地址：

• HTTPS: [***]

安全注意事项

[!WARNING] 该容器提供对主机系统的特权访问，未正确配置时不要暴露到互联网。

1. HTTPS要求：完整功能需要HTTPS支持，WebCodecs等现代浏览器特性不支持HTTP连接
2. 认证机制：
   • 默认无认证，可通过CUSTOM_USER和PASSWORD环境变量启用基础HTTP认证（仅适用于可信本地网络）
   • 互联网暴露时必须配合反向代理（如SWAG）及强认证机制
3. 权限风险：Web界面包含带无密码sudo权限的终端，任何有权访问GUI的用户可获取容器内root权限
4. Seccomp配置：老旧内核或libseccomp版本可能需要添加--security-opt seccomp=unconfined参数（禁用关键安全层，仅在必要时使用）

反向代理配置

默认使用自签名证书（HTTPS），若反向代理验证证书，需禁用容器证书检查。

环境变量配置

该镜像基于Docker Baseimage Selkies构建，支持以下环境变量：

基础环境变量

Selkies特有环境变量

运行参数配置

语言支持

通过LC_ALL环境变量设置界面语言：

DRI3 GPU加速

添加--device /dev/dri:/dev/dri参数可挂载GPU设备，支持以下开源驱动：

可通过DRINODE环境变量指定特定GPU设备节点。

应用管理

PRoot Apps (持久化，推荐)

系统级安装的应用（如apt-get install）在容器重建后不保留，推荐使用proot-apps安装到用户$HOME目录（持久化）：

bash
proot-apps install filezilla

支持的应用列表

Native Apps (非持久化)

通过universal-package-install mod安装系统原生包（容器重建后需重新安装）：

yaml
environment:
  - DOCKER_MODS=linuxserver/mods:universal-package-install
  - INSTALL_PACKAGES=libfuse2|git|gdb

用户/组ID设置

使用卷挂载时，通过PUID和PGID确保权限匹配，避免权限问题：

1. 查看主机用户ID和组ID：

   bash
   id your_user
   

   输出示例：

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

2. 在环境变量中设置对应值：

   -e PUID=1000 -e PGID=1000
   

Docker Mods

![Docker Mods]([] ![Docker Universal Mods]([]

可通过Docker Mods扩展功能，支持的mods列表见上方链接。

支持信息

• 容器内Shell访问：

  bash
  docker exec -it filezilla /bin/bash
  

• 实时查看日志：

  bash
  docker logs -f filezilla
  

• 查看容器版本：

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

• 查看镜像版本：

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

更新方法

Docker Compose

bash
# 更新镜像
docker-compose pull filezilla

# 更新容器
docker-compose up -d filezilla

# 清理旧镜像
docker image prune

Docker Run

bash
# 更新镜像
docker pull lscr.io/linuxserver/filezilla:latest

# 停止并删除旧容器
docker stop filezilla && docker rm filezilla

# 用原参数启动新容器（/config卷挂载正确时配置会保留）
docker run -d [原参数] lscr.io/linuxserver/filezilla:latest

# 清理旧镜像
docker image prune

本地构建

bash
git clone [***]
cd docker-filezilla
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/filezilla:latest .

跨架构构建（需qemu-static）：

bash
docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
docker build -f Dockerfile.aarch64 -t lscr.io/linuxserver/filezilla:arm64v8-latest .

版本历史

• 26.07.25: - 基于Selkies和Alpine 3.22重建，HTTPS成为必需
• 06.12.24: - 基于Alpine 3.21重建
• 23.05.24: - 基于Alpine 3.20重建
• 10.02.24: - 更新README，添加新环境变量，支持PWA图标
• 02.01.24: - 基于Alpine 3.19重建
• 03.07.23: - 移除armhf支持
• 13.05.23: - 基于Alpine 3.18重建
• 18.03.23: - 基于KasmVNC基础镜像重建
• 21.10.22: - 基于Alpine 3.16重建，迁移至s6v3
• 23.12.21: - 基于Alpine 3.15重建
• 26.09.21: - 基于Alpine 3.14重建
• 18.04.21: - 初始发布