feat: add Dockerfile, entrypoint.sh and .env.example

.env.example

@@ -0,0 +1,30 @@
+########################################
+#        Hugging Face Space 示例环境变量
+# 仅远程MySQL数据库，无本地SQLite等，所有配置均使用 ENV 注入
+########################################
+
+# [必填] 监听端口，被 Space 探测用，强烈建议 7860（默认已固定脚本为7860，无特殊需求无需更改）
+PORT=7860
+
+# [必填] 数据库类型，固定为mysql，entrypoint已自动设定
+# DB_TYPE=mysql
+
+# [二选一] 推荐关键参数按字段配置（推荐直接在Space设置获取安全性）
+DB_HOST=your.mysql.host
+DB_PORT=3306
+DB_USER=alistuser
+DB_PASS=secret_pass
+DB_NAME=alistdb
+
+# 或 [可选，高级] 直接传完整 MySQL DSN 字符串（优先级更高，不需要上面DB_*）
+# 格式：user:password@tcp(host:port)/dbname?charset=utf8mb4&parseTime=True&loc=Local
+# DB_DSN=alistuser:secret_pass@tcp(your.mysql.host:3306)/alistdb?charset=utf8mb4&parseTime=True&loc=Local
+
+# [可选] 管理员初始密码（推荐仅首次启动，如已有数据库会跳过）
+# ALIST_ADMIN_PASSWORD=your-admin-password
+
+########################################
+# 注意：
+# - 禁止使用 SQLite，本模板仅支持远程MySQL。
+# - 所有敏感信息仅在 Space 控制台填写，不要同步到公有仓库。
+########################################

Dockerfile

@@ -0,0 +1,35 @@
+# 用于 Hugging Face Space 部署的alists主Dockerfile
+FROM golang:1.21-alpine AS build
+
+WORKDIR /build
+
+COPY . .
+
+RUN apk add --no-cache git && \
+    go mod download && \
+    CGO_ENABLED=0 GOOS=linux go build -trimpath -ldflags="-s -w" -o /app/alist main.go
+
+# 生产阶段
+FROM alpine:3.19
+
+WORKDIR /app
+
+# 拷贝可执行文件和入口脚本
+COPY --from=build /app/alist /app/alist
+COPY entrypoint.sh /app/entrypoint.sh
+
+# 可选：拷贝必要的静态资源等，如果需要可用以下行
+# COPY public /app/public
+# COPY config /app/config
+
+# 必须赋予启动脚本可执行
+RUN chmod +x /app/entrypoint.sh
+
+# 端口，Hugging Face Space 默认探测
+EXPOSE 7860
+
+# HEALTHCHECK：确保平台探测健康，默认 get /ping （alist部分版本支持）可按需调整
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 CMD wget -qO- http://localhost:7860/ping || exit 1
+
+# 入口
+ENTRYPOINT ["/app/entrypoint.sh"]

README.md

@@ -1 +1 @@
-# alist for Hugging Face Space
+sdk: docker

entrypoint.sh

@@ -0,0 +1,28 @@
+#!/bin/sh
+
+set -e
+
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+
+# 默认端口
+PORT=${PORT:-7860}
+export HTTP_PORT=${PORT}
+export DB_TYPE=mysql
+
+echo "Using PORT=${HTTP_PORT} for Hugging Face Space"
+
+# 校验 MySQL 连接参数，优先DSN
+if [ -n "$DB_DSN" ]; then
+    echo "Using custom DB_DSN for MySQL connection."
+elif [ -z "$DB_HOST" ] || [ -z "$DB_PORT" ] || [ -z "$DB_USER" ] || [ -z "$DB_PASS" ] || [ -z "$DB_NAME" ]; then
+    echo "${RED}ERROR: 必须设置 MySQL 数据库环境变量（DB_HOST, DB_PORT, DB_USER, DB_PASS, DB_NAME），或 DB_DSN！${NC}"
+    exit 1
+fi
+
+# 日志文件夹可选创建，也可用 docker 挂载
+mkdir -p /app/data/log
+
+# 启动 alist，日志直接前台输出
+echo "Starting alist server ..."
+exec /app/alist server --no-prefix