一、iFileSpace介绍

1.1 iFileSpace简介

iFileSpace 是一款开源的在线个人文件管理工具，支持一键搭建私有云盘，兼容本地存储与主流第三方对象存储服务，适用于公网服务器、NAS 或家庭软路由，实现数据完全自主可控的私有网盘解决方案。

1.2 iFileSpace主要特点

1. 多存储支持：兼容本地存储及阿里云 OSS、腾讯云 COS、华为云 OBS、又拍云、七牛云、OneDrive 和其他 S3 协议对象存储。
2. 客户端直传：第三方存储支持客户端直传，绕过服务器带宽限制，提升上传效率。
3. WebDAV 支持：提供标准 WebDAV 接口，便于与其他应用集成或挂载为本地磁盘。
4. 离线下载功能：支持通过链接远程下载文件到云盘，无需本地中转。
5. 相册自动备份：移动端可自动备份照片至指定存储空间。
6. 灵活文件分享：支持直链分享、密码保护分享、群组分享及用户间私密分享。
7. 在线预览能力：可直接在网页预览视频、图片、音频、文本、Office 文档和 PDF 文件。
8. 多用户与权限管理：支持多用户体系及精细化后台权限控制，适合团队或家庭使用。
9. 多存储空间与策略：每个用户可配置多个存储空间，并设定不同存储策略。
10. 全平台客户端：提供 iOS、Android 移动端及 Windows、macOS 桌面客户端，操作更便捷。
11. 自动文件扫描：定时扫描用户目录，自动同步新增或变更的文件与文件夹。
12. 单文件部署：打包为单一可执行文件，部署简单快速。
13. Docker 支持：提供 Docker 镜像，便于容器化部署与管理。
14. 界面自定义：Web 端支持自定义 Logo 与首页内容，打造个性化网盘界面。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署iFileSpace文件管理工具。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Sun 2025-11-02 07:06:57 UTC; 3 days ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 889 (dockerd)
      Tasks: 82
     Memory: 1.1G (peak: 2.8G)
        CPU: 6min 1.860s
     CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本

root@jeven:~# docker -v
Docker version 28.5.0, build 887030f

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven:~# docker compose version
Docker Compose version v2.39.4

四、拉取iFileSpace镜像

下载iFileSpace镜像，镜像名称为：docker pull lgs821/ifile:2.5.9

root@jeven:~# docker pull lgs821/ifile:2.5.9
2.5.9: Pulling from lgs821/ifile
f18232174bc9: Already exists
2ae154685440: Pull complete
7e6a77fd1998: Pull complete
c8dbad671845: Pull complete
Digest: sha256:83e6fbef545343082a3692a59e4a04ce9fb51b2a9d0998e0289d0bd89474cc6a
Status: Downloaded newer image for lgs821/ifile:2.5.9
docker.io/lgs821/ifile:2.5.9

五、部署iFileSpace服务

5.1 docker-cli方式部署（可选）

• 如果使用docker-cli方式部署，可参考以下官方命令：

docker run --name ifile -p 3030:3030 -v ~/ifile/conf:/ifile/conf -v ~/ifile/files:/ifile/files -v ~/ifile/data:/ifile/data -v ~/ifile/assets:/ifile/assets -v ~/ifile/tmp:/ifile/tmp -v ~/ifile/thumb:/ifile/thumb -v ~/ifile/logs:/ifile/logs -v ~/ifile/library:/ifile/library -d lgs821/ifile

#替换 ‘~/ifile’ 为您的路径
# -v ~/ifile/conf:/ifile/conf 映射配置文件目录
# -v ~/ifile/files:/ifile/files 映射宿主机文件夹为默认存储空间
# -v ~/ifile/data:/ifile/data 映射数据库文件夹
# -v ~/ifile/assets:/ifile/assets 映射自定义相关文件夹
# -v ~/ifile/tmp:/ifile/tmp 分片上传临时文件夹
# -v ~/ifile/thumb:/ifile/thumb 图片缩略图缓存目录
# -v ~/ifile/logs:/ifile/logs 日志保存目录
# -v ~/ifile/library:/ifile/library 默认资料库目录

5.2 docker compose方式部署

• 创建部署目录

mkdir -p /data/ifile  && cd /data/ifile

• 目录授权

chmod -R 777 /data/ifile

新建及编辑docker-compose.yaml文件，宿主机映射端口可自行设置，注意防止端口冲突。

vim docker-compose.yaml

services:
  ifile:
    image: lgs821/ifile:2.5.9
    container_name: ifile
    ports:
      - "3030:3030" 
    volumes:
      - ./ifile/conf:/ifile/conf        # 映射配置文件目录
      - ./ifile/files:/ifile/files      # 映射宿主机文件夹为默认存储空间
      - ./ifile/data:/ifile/data        # 映射数据库文件夹
      - ./ifile/assets:/ifile/assets    # 映射自定义相关文件夹
      - ./ifile/tmp:/ifile/tmp          # 分片上传临时文件夹
      - ./ifile/thumb:/ifile/thumb      # 图片缩略图缓存目录
      - ./ifile/logs:/ifile/logs        # 日志保存目录
      - ./ifile/library:/ifile/library  # 默认资料库目录
    restart: unless-stopped    

5.3 创建iFileSpace容器

执行以下命令，创建iFileSpace容器。

docker compose up -d

5.4 查看iFileSpace容器状态

检查iFileSpace容器运行状态，确保iFileSpace容器正常启动。

root@jeven:/data/ifile#  docker compose ps
NAME      IMAGE                COMMAND     SERVICE   CREATED          STATUS          PORTS
ifile     lgs821/ifile:2.5.9   "./ifile"   ifile     26 seconds ago   Up 26 seconds   0.0.0.0:3030->3030/tcp, [::]:3030->3030/tcp

5.5 检查iFileSpace容器日志

检查容器运行日志，确保iFileSpace服务正常运行。

docker compose logs

六、访问iFileSpace服务

6.1 访问iFileSpace初始页

浏览器地址： http://<个人的服务器IP>:3030，访问iFileSpace初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

6.2 初始配置工作

iFileSpace 支持连接外部 MySQL 数据库，也支持使用 SQLite。在测试环境中，我们选择 SQLite；填写站点名称及管理员账号密码后，点击确认即可完成初始化。

6.3 登录iFileSpace

初始化完毕后，使用设置的账号密码重新登录iFileSpace。

6.4 上传文件

上传本地文件到iFileSpace，效果如下所示。如果需要在线编辑文档，可在系统设置中对接onlyoffice。

七、总结

本次实践成功通过 Docker 快速部署了 iFileSpace 文件管理工具，验证了其在容器化环境下的便捷性和稳定性。借助 docker-compose 方式，实现了服务的一键启动与配置，大幅简化了部署流程。初始化配置完成后，iFileSpace 提供了直观的 Web 界面和丰富的文件管理功能，包括多存储支持、在线预览和分享能力。整体来看，iFileSpace 是一个轻量、灵活且适合个人或小团队使用的私有云盘解决方案。