為了讓自己的llm bot有自定義的發圖能力就用claude和gemini幫我寫了個隨機api的圖床
倉庫地址如下：

圖床轉發 (Image-Forward)

一個(ge)基(ji)于(yu)Python Flask的圖(tu)片(pian)合集(ji)管理和隨(sui)機轉發服務。

功能特點

• 管理界面，支持創建、查看、編輯和刪除圖片合集
• 支持上傳本地圖片和添加外部圖片鏈接
• 通過特定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，從(cong)而(er)完全控(kong)制配(pei)置。詳見下(xia)面的(de) "Docker部署" 部分(fen)。

重要配置項說明：

• 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 文(wen)件，然后重啟(qi)應用。

2. 本地運行

安裝依賴：

pip install -r requirements.txt

啟動應用：

python run.py

3. Docker部署

使用(yong) 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）來完全替換應用內的默認配置。

使用指南

訪問地址

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

管理流程

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

數據存儲

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

主頁

合集界面

管理界面