项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
技术标签
使用教程
—
环境要求
- 已安装 Docker 与 Docker Compose（README 推荐用 Docker Compose 部署）
- 网络可访问 GitHub 以下载 compose.yaml 文件
- 一个用于存放配置与数据的目录（compose.yaml 中定义）
安装与启动步骤
-
1下载编排文件
从 Foxel 官方仓库拉取 compose.yaml，保存到本机部署目录中，后续所有操作都基于该文件。
curl -L -O https://github.com/DrizzleTime/Foxel/raw/main/compose.yaml -
2修改安全密钥
README 强烈建议修改 compose.yaml 中的环境变量，把默认密钥换成随机生成的强密钥，避免被他人利用。
-
3启动 Foxel
在 compose.yaml 所在目录用 Docker Compose 拉起服务，README 指明这是最推荐的启动方式。
docker compose up -d
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
SECRET_KEY | 是 | 服务主密钥，README 要求替换默认值为随机强密钥 | 请替换为随机生成的强密钥 |
TEMP_LINK_SECRET_KEY | 是 | 临时链接签名密钥，README 要求替换默认值为随机强密钥 | 请替换为随机生成的强密钥 |
如何确认成功
README 未给出具体验证命令；容器正常启动后，用浏览器访问 compose.yaml 中配置的服务地址即可。
常见问题
Q：推荐哪种部署方式？
A：README 明确说明使用 Docker Compose 是最推荐的启动方式，因此优先按本文步骤用 compose.yaml 部署。
Q：默认密钥可以直接用吗？
A：不建议。README 强烈建议修改 SECRET_KEY 和 TEMP_LINK_SECRET_KEY，替换为随机生成的强密钥后再启动。
Q：能先看看界面效果吗？
A：可以，官方在线演示地址为 https://demo.foxel.cc ，账号 admin，密码 admin。
Q：支持接入哪些存储？
A：支持本地、S3 兼容、WebDAV、SFTP、FTP、SMB，以及 Google Drive、OneDrive、Dropbox、Telegram、AList 等多种后端。
注意事项
- UC、123Pan、115、189、SMB、Seafile、Cloudreve V4 等适配器使用账号或服务器凭证，而不是开发者 SDK Key，配置方式见 docs/storage-adapters.md。
- compose.yaml 下载后建议先改密钥再启动，不要直接使用默认配置对外提供服务。
- README 节选中缺少第一步（如创建目录）的说明，请以仓库中完整的 compose.yaml 内容为准。
- 官网 https://foxel.cc 可获取更多项目信息与文档。
核心亮点
- AI 语义搜索是核心差异点，支持用自然语言描述内容来定位文件，而非依赖文件名或标签
- 技术栈现代且清晰，Python 后端配 React + TypeScript 前端，便于二次开发和界面定制
- 覆盖图片、照片画廊、视频等多媒体场景，不只是冷冰冰的文件仓库，适合个人媒体库
不足之处
- 项目仍处于成长阶段，文档完整度和部署指引可能不够成熟
- AI 语义搜索依赖模型与索引构建，对硬件资源和初始配置有一定门槛
适用场景
- 个人或家庭自建 NAS，把多年照片视频集中管理并用自然语言快速检索
- 小团队搭建内部私有文件库，存放合同、设计稿等资料并支持语义查找
- 摄影或视频创作者管理素材库，按画面内容而非文件夹名定位原始文件
替代项目
Nextcloud、Immich、Seafile
上一篇：ck
下一篇：没有了！
同类项目推荐
firecrawl
开源
网页抓取像喝水一样简单，开发者省下整周加班
Supercharge your AI agents with data from the web and beyond. Building the library f···
contoso-chat
开源
一键跑通 Azure RAG 应用，从代码到评估部署全流程
This sample has the full End2End process of creating RAG application with Prompty an···
graphify
开源
整个代码库画成一张图，找问题一眼定位
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable k···
WeKnora
开源
文档往里一扔，自动变成啥都能答的知识库
Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an auto···