# 快速开始

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

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

***

### 一键部署

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

```bash
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 目前处于**早期实验阶段**，数据库结构和功能仍在持续更新。
* 未来版本可能会有较大变动，**建议生产环境部署前充分测试，并关注项目更新动态**。

***

### 交流与反馈

* 问题反馈请提交 [GitHub Issues](https://github.com/DrizzleTime/Foxel/issues)
* 欢迎 PR 与建议！

***

祝你使用愉快！

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.foxel.cc/start/kuai-su-kai-shi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.