隨機圖床

為了讓自己的llm bot有自定義的發圖能力就用claude和gemini幫我寫了個隨機api的圖床
倉庫地址如下：https://github.com/lumia1998/image-forward

圖床轉發 (Image-Forward)

一個基于Python Flask的圖片合集管理和隨機轉發服務。

功能特點

管理界面，支持創建、查看、編輯和刪除圖片合集
支持上傳本地圖片和添加外部圖片鏈接
通過特定URL隨機返回合集中的圖片（本地圖片直接返回，外鏈HTTP重定向）
支持Docker部署
統一的背景圖片和可配置的透明度

快速開始

1. 環境配置

使用 .env 文件：編輯根目錄的 .env 的文件。此文件中的環境變量（例如 ADMIN_PASSWORD=mysecret 或 APP_NAME="我的圖床"）將在應用啟動時加載，并覆蓋 config.py 中的相應默認值。
```
# .env 示例
ADMIN_PASSWORD=your_secure_password
APP_NAME=我的自定義圖床名稱
DEBUG=True
# SECRET_KEY=your_very_secret_key_for_production # 強烈建議在生產環境中設置此項
# PORT=5000
```
Docker 用戶映射自定義 config.py：如果您使用 Docker 部署，可以通過 docker-compose.yml 文件中的 volumes 指令，將宿主機上的自定義 config.py 文件映射到容器內的 /app/config.py，從而完全控制配置。詳見下面的 "Docker部署" 部分。

重要配置項說明：

ADMIN_PASSWORD: 管理員登錄密碼。
APP_NAME: 應用顯示的名稱。
BACKGROUND_IMAGE_PATH: 統一的背景圖片文件名（應存放于 app/background/ 目錄）。
BACKGROUND_OPACITY: 背景圖片的透明度（0.1 到 1.0）。
SECRET_KEY: Flask 應用的密鑰，用于會話管理等，在生產環境中務必設置為一個復雜且唯一的字符串。
DEBUG: 是否開啟調試模式。生產環境建議設為 False。
PORT: 應用運行的端口。

注意：通過管理界面進行的配置更改（如應用名稱、背景圖片、透明度）僅在當前應用會話中有效，不會被持久化保存。要使更改永久生效，您需要修改項目根目錄下的 .env 文件，或者（如果使用了 Docker 并映射了自定義 config.py）修改您映射的 config.py 文件，然后重啟應用。

2. 本地運行

安裝依賴：

pip install -r requirements.txt

啟動應用：

python run.py

3. Docker部署

使用 Docker Compose 啟動服務：

docker-compose up -d --build

docker-compose.yml 文件配置如下：

version: '3.8'

services:
  web:
    build: .
    container_name: image_forward_app
    ports:
      - "46000:46000" # 將配置的端口映射到主機
    env_file:
      - .env # 從項目根目錄的 .env 文件加載環境變量到容器
    volumes:
      - ./picture:/app/picture # 持久化圖片存儲
      - ./app/background:/app/background # 映射背景圖片目錄
      # 如需使用自定義的 config.py 文件，請取消下面一行的注釋，
      # 并確保 'my_custom_config.py' (或您選擇的文件名) 存在于 docker-compose.yml 同級目錄。
      # - ./my_custom_config.py:/app/config.py
    restart: unless-stopped

這允許您：

通過在項目根目錄創建和修改 .env 文件來覆蓋默認配置。
（可選）通過取消注釋并提供您自己的 config.py 文件（例如 my_custom_config.py）來完全替換應用內的默認配置。

使用指南

訪問地址

主頁：http://127.0.0.1:PORT/ (PORT 為您配置的端口，默認為 46000)
管理界面：http://127.0.0.1:PORT/admin
隨機轉發：http://127.0.0.1:PORT/合集名稱

管理流程

訪問管理界面并使用您在配置文件 (config.py 或通過 .env 文件覆蓋的) 中設置的管理員密碼登錄。
創建新的圖片合集。
上傳本地圖片或添加外部圖片鏈接。
通過隨機轉發URL測試功能。

數據存儲

所有圖片和外鏈數據存儲在項目運行目錄下的 /picture 文件夾中
每個圖片合集對應 /picture 下的一個子文件夾。
合集下的本地圖片直接存儲在該子文件夾中。
合集下的外部鏈接集中存儲在子文件夾內一個與合集同名的 .txt 文件中。
背景圖片存儲在 /app/background 目錄中。

主頁

合集界面

管理界面

posted @ 2025-11-03 16:02 太陽與向日葵閱讀(100) 評論(0) 收藏舉報

刷新頁面返回頂部

lumia1998