bullseye-arrow快速开始

欢迎使用 Foxel 一款基于 .NET 9 构建的现代化智能图像检索与管理系统。Foxel 融合了先进的 AI 视觉模型与向量嵌入技术,提供高效、智能的图像搜索与管理体验。

本页将引导你快速搭建并运行 Foxel。


一键部署

Foxel 提供开箱即用的容器化部署方式,您可以通过如下命令一键启动:

docker run -d -p 80:80 --name foxel \
-v /path/to/uploads:/app/Uploads \
-e 'DEFAULT_CONNECTION=Host=foxel;Username=foxel_dev;Password=foxel;Database=foxel_dev' \
--pull always \
ghcr.io/drizzletime/foxel:dev

⚠️ 重要提示: 请根据您的实际环境,替换上述命令中的参数:

  • 数据库连接配置 (DEFAULT_CONNECTION)

    • Host:数据库主机地址

    • Username:数据库用户名

    • Password:数据库密码

    • Database:数据库名称

  • 端口映射配置 (-p)

    • 例如 -p 8080:80 可将容器 80 端口映射到主机 8080 端口

  • 数据挂载配置 (-v)

    • /path/to/uploads 替换为实际希望存储图片的主机路径


访问服务

部署完成后,打开浏览器访问您的服务器 IP 地址即可使用 Foxel。


管理员权限获取

容器启动后,第一个注册的用户将自动获得管理员权限


数据库要求

  • Foxel 依赖 PostgreSQL 数据库,并需要在数据库中启用 vector 扩展

  • 请确保您的 PostgreSQL 实例已正确安装并启用 vector 扩展,否则安装将失败。


重要说明

  • Foxel 目前处于早期实验阶段,数据库结构和功能仍在持续更新。

  • 未来版本可能会有较大变动,建议生产环境部署前充分测试,并关注项目更新动态


交流与反馈


祝你使用愉快!


最后更新于

这有帮助吗?