KiteKite

快速开始

5 分钟启动你的第一个 Kite 实例，完成首次登录与初始化。

本章介绍启动 Kite 最快的两种方式：Docker 与二进制。选择任意一种后，打开浏览器即可完成初始化。

通过 Docker 启动

这是推荐的启动方式，适合大部分生产与体验场景。

BASH
docker run -d \
  --name kite \
  -p 8080:8080 \
  -v $(pwd)/data:/app/data \
  amigoer/kite:latest

启动后访问 http://localhost:8080 即可进入 Kite。

说明

-v $(pwd)/data:/app/data 将数据目录挂载到宿主机，包含 SQLite 数据库和本地上传的文件。请务必持久化此目录，否则容器重建会丢失所有数据。

使用 Docker Compose

项目仓库的 deploy/docker-compose.yml 已提供了完整的 Kite + Nginx 组合：

YAML
services:
  kite:
    image: amigoer/kite:latest
    restart: unless-stopped
    expose:
      - "8080"
    environment:
      KITE_SITE_URL: https://your-domain.com
      KITE_DB_DRIVER: sqlite
      KITE_DSN: /app/data/kite.db
      TZ: Asia/Shanghai
    volumes:
      - ./data:/app/data

执行：

BASH
docker compose up -d

通过二进制启动

从 GitHub Releases 下载对应平台的压缩包：

BASH
# Linux amd64 示例
curl -LO https://github.com/amigoer/kite/releases/latest/download/kite-linux-amd64.tar.gz
tar -xzf kite-linux-amd64.tar.gz
chmod +x kite

# 启动
./kite

默认监听 0.0.0.0:8080，数据库位于当前目录下的 data/kite.db。

从源码构建

若希望自行构建，需要安装 Go 1.25+ 与 Node.js 22+：

BASH
git clone https://github.com/amigoer/kite.git
cd kite

# 一条命令完成前端构建 + Go 编译 + 运行
make run

构建产物位于 build/kite，前端资源已内嵌。

首次启动

Kite 首次启动会自动完成以下动作：

  1. 创建数据目录：若 KITE_DSN 指向的目录不存在，自动创建。
  2. 自动迁移数据库：使用 GORM 创建表结构。
  3. 生成 JWT 密钥：生成 32 字节随机密钥并持久化到 settings 表。
  4. 创建默认本地存储：路径为 data/uploads。
  5. 创建默认管理员账号：
    • 用户名 admin
    • 密码 admin
    • 标记为「首次登录必须重置」
注意

默认账号仅用于首次登录，启动日志中会打印如下警示：

TEXT
⚠️  Default admin account created with WEAK credentials:
      Username: admin
      Password: admin
  You MUST change the username and password on first login.
  Do NOT expose this server to the public internet until you
  have completed the first-login reset.

请勿在完成首次重置前将实例暴露到公网。

完成首次登录

浏览器访问 http://localhost:8080，点击「登录」：

  1. 使用 admin / admin 登录
  2. 系统会强制跳转到「重置账号」页面
  3. 设置新的用户名、邮箱和密码
  4. 重置完成后自动登录到管理后台

上传第一张图片

进入后台后：

  1. 点击左侧「文件」→「上传」
  2. 拖拽或选择文件上传
  3. 上传成功后复制链接，即可在任意位置引用

也可以通过 API 或 PicGo 等客户端上传，详见第三方客户端对接。

下一步