lsiodev/filezilla

linuxserver/filezilla

FileZilla客户端是一款快速可靠的跨平台FTP、FTPS和SFTP客户端，具有丰富实用的功能和直观的图形用户界面。本镜像由LinuxServer.io团队提供，基于KasmVNC基础镜像，支持通过Web浏览器访问FileZilla桌面界面。

支持的架构

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

应用设置

应用可通过以下地址访问：

• [***]你的主机IP:3000/
• [***]你的主机IP:3001/

KasmVNC基础GUI容器通用选项

本容器基于https://github.com/linuxserver/docker-baseimage-kasmvnc，支持以下额外环境变量和运行配置：

可选环境变量

可选运行配置

无损模式

通过将"Stream Quality"预设改为"Lossless"，容器可向浏览器传输真正的无损图像并保持高帧率，详情见https://www.kasmweb.com/docs/latest/how_to/lossless.html#technical-background。非本地访问时需使用3001端口的HTTPS，反向代理至3000端口时需设置特定 headers，详见https://github.com/linuxserver/docker-baseimage-kasmvnc#lossless。

使用方法

docker-compose（推荐）

yaml
---
version: "2.1"
services:
  filezilla:
    image: docker.xuanyuan.run/linuxserver/filezilla:latest
    container_name: filezilla
    security_opt:
      - seccomp:unconfined #可选
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/config:/config
    ports:
      - 3000:3000
      - 3001:3001
    restart: unless-stopped

docker cli

bash
docker run -d \
  --name=filezilla \
  --security-opt seccomp=unconfined `#可选` \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 3000:3000 \
  -p 3001:3001 \
  -v /path/to/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/filezilla:latest

参数说明

环境变量文件（Docker secrets）

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

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

将从/run/secrets/mysecretvariable文件内容设置MYVAR变量。

应用运行Umask设置

可通过-e UMASK=022覆盖容器内服务的默认umask设置。umask通过减法调整权限，而非直接设置权限，详情参考umask说明。

用户/组ID

使用卷挂载时，主机与容器可能出现权限问题。通过指定PUID（用户ID）和PGID（组ID），确保主机卷目录与容器内用户权限一致。使用id your_user命令获取当前用户的ID：

bash
id your_user

输出示例：

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

Docker Mods

LinuxServer.io提供多种https://github.com/linuxserver/docker-mods以扩展容器功能，上述徽章链接可查看适用于本镜像的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

• 更新镜像：

  • 所有镜像：docker-compose pull
  • 单个镜像：docker-compose pull filezilla

• 更新容器：

  • 所有容器：docker-compose up -d
  • 单个容器：docker-compose up -d filezilla

• 清理旧镜像：docker image prune

通过Docker Run

• 更新镜像：docker pull docker.xuanyuan.run/linuxserver/filezilla:latest
• 停止容器：docker stop filezilla
• 删除容器：docker rm filezilla
• 使用原参数重建容器（配置文件在/config卷中会保留）
• 清理旧镜像：docker image prune

通过Watchtower自动更新（仅推荐用于忘记原始参数时）

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/containrrr/watchtower \
  --run-once filezilla

清理旧镜像：docker image prune

警告：不建议使用Watchtower作为容器自动更新方案，长期推荐使用https://docs.linuxserver.io/general/docker-compose。

镜像更新通知 - Diun

推荐使用https://crazymax.dev/diun/接收更新通知，不建议使用自动更新容器的工具。

本地构建

如需本地修改或开发：

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

在x86_64硬件上构建ARM变体需使用multiarch/qemu-user-static：

bash
docker run --rm --privileged docker.xuanyuan.run/multiarch/qemu-user-static:register --reset

然后使用-f Dockerfile.aarch64指定架构Dockerfile。

版本历史

• 03.07.23: 弃用armhf架构（详见https://www.linuxserver.io/blog/a-farewell-to-arm-hf）
• 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: 初始发布