iFileSpace

在线个人文件管理工具,可快速一键搭建私人云盘,支持本地存储和对象存储

更新时间:2025-05-19 16:21:29

访问次数:246

详细介绍

iFileSpace

iFileSpace 是一个基于 Vue 和 Express 开发的轻量级私有网盘,界面简洁美观,支持多用户、文件管理、上传下载等功能,非常适合个人或小型团队使用。

本教程将手把手教你如何用 Docker 快速部署 iFileSpace,适用于 VPS、自建服务器或本地环境。

🧱 一、准备工作

已安装宝塔面板(推荐使用 Ubuntu/Debian)

宝塔已安装 Docker 管理器插件

👉 安装方法:宝塔面板左侧菜单 ➜ 软件商店 ➜ 搜索并安装“Docker 管理器”

🧩 二、拉取镜像,创建容器

打开宝塔 ➜ 左侧菜单进入 终端 页面,输入命令

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

下载安装后界面(首次需等待几分钟)

iFileSpace docker安装

注:路径可以自行更改,不改也没关系

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

🌐 三、访问网盘

部署完成后,直接访问服务器地址:

http://你的服务器IP:3030

iFileSpace 初始化

初始化界面根据自己需要配置,数据库推荐MySQL,也可SQLite。

下一步进行初始化,访问IP:3030就到登陆页面

iFileSpace 登录界面

🔐 四、配置 HTTPS(可选)

如你已在宝塔中绑定域名,可使用宝塔网站反向代理 “网站 ➜ 添加站点➜ 输入域名➜确认反向代理添加反向代理” 开启 HTTPS,并使用反向代理连接:

示例反向代理设置:

宝塔反向代理配置

开启代理:

代理名称:随意填

目标 URL:http://127.0.0.1:3030

Nginx 反向代理需添加:

proxy_set_header X-Forwarded-Proto $scheme;

把这行代码添加到配置文件

iFileSpace 用宝塔反向代理配置

Nginx 反向代理示例:

server {
  listen       80;
  server_name  demo.ifile.space;

  location / {
    proxy_pass http://127.0.0.1:3030;
    proxy_set_header Host $host:$server_port;
    proxy_set_header X-Real-IP       $remote_addr;
    proxy_set_header X-Forwarded-For  $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;   
  }

  location /ws {
    proxy_pass http://127.0.0.1:3030;
    proxy_set_header Host $host:$server_port;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
  }
}

选择SSL申请Let's Encrypt证书,就可开启HTTPS加密

iFileSpace 申请免费ssl证书

⚙️ 五、常见问题

1. 容器无法启动?

检查是否端口冲突、目录权限问题,建议将宿主目录设置为 755 权限。

2. 关于获取空间失败

目前使用sqlite安装,在多文件上传的情况下 大概率会出现 获取空间失败的错误提示,是由于sqlite的处理并发的能力不足,如需稳定使用,建议安装mysql或者mariadb使用,后续会持续优化sqlite部署的错误问题。

3.自定义标题及logo

自定义首页logo:在新建的assets文件夹下新建 loginlogo.png 用来覆盖登录页logo。

🧼 六、停止或卸载服务

如需关闭:

# 在宝塔 Docker 插件中操作:

容器列表 ➜ 选中 ifile ➜ 停止 / 删除

数据默认保存在 /www/dk_project/dk_app/ifile,只要该目录不删,文件不会丢失。

✅ 七、总结

通过宝塔的 Docker 插件,部署 iFileSpace 无需写一行命令,非常适合小白入门部署开源网盘系统。如果你希望拥有一个安全、私密的文件存储空间,这将是一个极具性价比的解决方案。

如你有更多需求,如自动备份、对象存储对接、微信扫码登录等扩展玩法,欢迎继续交流。


分享到:

猜你喜欢

网友评论