unis_manager/scripts/run.sh

306 lines
9.9 KiB
Bash
Executable File
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

#!/usr/bin/env bash
# DMS管理平台 · 本地启动脚本(macOS / Linux / Windows Git Bash 均可)
#
# 用法:
# ./scripts/run.sh 正常启动(默认开热更新)
# PORT=8771 ./scripts/run.sh 换端口
# DEV=0 ./scripts/run.sh 关闭热更新
# NO_OPEN=1 ./scripts/run.sh 启动后不打开浏览器
# AUTO_INSTALL=0 ./scripts/run.sh 缺环境时不尝试自动安装,只打印安装命令
#
# 环境要求由脚本自动兜底:
# 1. 找 Python 3.10+(找不到时按 AUTO_INSTALL=1 尝试用系统包管理器安装)
# 2. 建项目内 .venv,缺依赖时自动 pip install -r requirements.txt(多源重试)
# 3. 缺 .env 时从 .env.example 生成,建好 data/ 目录,首次运行自动建库
# 4. 端口已被占用时直接提示访问地址,不重复起进程
set -euo pipefail
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
cd "$ROOT"
log() { printf '%s\n' "$*"; }
warn() { printf '!! %s\n' "$*" >&2; }
die() { printf '!! %s\n' "$*" >&2; exit 1; }
# 读取 .env 里的单值配置(不 source,避免特殊字符被执行)
env_get() {
[ -f .env ] || return 0
sed -n "s/^[[:space:]]*$1[[:space:]]*=//p" .env | tail -1 | sed 's/[[:space:]]*$//'
}
is_windows() {
case "$(uname -s)" in
MINGW*|MSYS*|CYGWIN*) return 0 ;;
*) return 1 ;;
esac
}
run_root() {
if [ "$(id -u)" = "0" ]; then
"$@"
elif command -v sudo >/dev/null 2>&1; then
# 交互式终端允许 sudo 提示密码;非交互(systemd / CI)时不要卡住等密码
if [ -t 0 ] || sudo -n true 2>/dev/null; then
sudo "$@"
else
return 1
fi
else
return 1
fi
}
# ---------- 配置 ----------
PORT="${PORT:-$(env_get PORT)}"
PORT="${PORT:-8770}"
DEV="${DEV:-$(env_get DEV)}"
DEV="${DEV:-1}"
export DEV
NO_OPEN="${NO_OPEN:-0}"
AUTO_INSTALL="${AUTO_INSTALL:-1}"
PIP_INDEX_URL="${PIP_INDEX_URL:-$(env_get PIP_INDEX_URL)}"
echo "==> DMS管理平台"
# ---------- 1. 找一个可用的 Python 3.10+ ----------
PY_SYS=""
find_python() {
local c
for c in "${PYTHON:-}" python3 python; do
[ -n "$c" ] || continue
command -v "$c" >/dev/null 2>&1 || continue
if "$c" -c 'import sys; raise SystemExit(0 if sys.version_info >= (3, 10) else 1)' >/dev/null 2>&1; then
PY_SYS="$(command -v "$c")"
return 0
fi
done
return 1
}
# 自动装 Python:只在明确缺解释器时触发,且需要包管理器 / 管理员权限
install_python() {
[ "$AUTO_INSTALL" = "1" ] || return 1
log "==> 未找到 Python 3.10+,尝试自动安装"
case "$(uname -s)" in
Darwin)
if command -v brew >/dev/null 2>&1; then
brew install python@3.12 && return 0
fi
warn "macOS 需要先装 Homebrew(https://brew.sh)或从 python.org 安装 Python 3.10+"
;;
Linux)
if command -v dnf >/dev/null 2>&1; then
run_root dnf install -y python3 python3-pip && return 0
elif command -v yum >/dev/null 2>&1; then
run_root yum install -y python3 python3-pip && return 0
elif command -v apt-get >/dev/null 2>&1; then
run_root apt-get update && run_root apt-get install -y python3 python3-venv python3-pip && return 0
elif command -v apk >/dev/null 2>&1; then
run_root apk add --no-cache python3 py3-pip && return 0
fi
;;
*)
;;
esac
return 1
}
if ! find_python; then
if install_python; then
find_python || die "Python 安装后仍不可用,请手动安装 Python 3.10+ 后重试"
else
die "没有找到 Python 3.10+。请先安装:
macOS : brew install python@3.12 或 https://www.python.org/downloads/
Ubuntu/Debian : sudo apt install -y python3 python3-venv python3-pip
RHEL/openEuler : sudo dnf install -y python3 python3-pip
然后重新执行:./scripts/run.sh"
fi
fi
log " 系统 Python:$PY_SYS ($("$PY_SYS" -V 2>&1))"
# ---------- 2. 端口占用检查(已在运行就直接给地址,省得重复启动) ----------
port_busy() {
"$PY_SYS" - "$PORT" <<'PY' >/dev/null 2>&1
import socket, sys
s = socket.socket()
s.settimeout(1.5)
sys.exit(0 if s.connect_ex(("127.0.0.1", int(sys.argv[1]))) == 0 else 1)
PY
}
health_url="http://127.0.0.1:${PORT}/health"
if port_busy; then
if command -v curl >/dev/null 2>&1 && curl -fsS --max-time 2 "$health_url" >/dev/null 2>&1; then
echo "==> 端口 ${PORT} 上已有 DMS 服务在运行"
echo " 看板地址: http://127.0.0.1:${PORT}"
echo " (要重启请先在原窗口按 Ctrl+C,或执行:lsof -ti:${PORT} | xargs kill)"
exit 0
fi
die "端口 ${PORT} 已被其他程序占用。换一个端口:PORT=8771 ./scripts/run.sh
或找出占用进程:lsof -ti:${PORT} | xargs kill"
fi
# ---------- 3. .env 与数据目录 ----------
if [ ! -f .env ]; then
cp .env.example .env
log "==> 已从 .env.example 生成 .env(AI Key、管理员密码按需修改)"
fi
mkdir -p data/uploads data/exports data/import
# ---------- 4. 项目内虚拟环境(缺依赖自动安装) ----------
VENV_DIR="$ROOT/.venv"
if is_windows; then
VENV_PY="$VENV_DIR/Scripts/python.exe"
else
VENV_PY="$VENV_DIR/bin/python"
fi
# 兼容在另一种 shell 下建好的 .venv
if [ ! -x "$VENV_PY" ]; then
for cand in "$VENV_DIR/bin/python" "$VENV_DIR/Scripts/python.exe"; do
if [ -x "$cand" ]; then VENV_PY="$cand"; break; fi
done
fi
install_venv_support() {
[ "$AUTO_INSTALL" = "1" ] || return 1
case "$(uname -s)" in
Linux)
if command -v apt-get >/dev/null 2>&1; then
run_root apt-get update && run_root apt-get install -y python3-venv
elif command -v dnf >/dev/null 2>&1; then
run_root dnf install -y python3-pip
elif command -v yum >/dev/null 2>&1; then
run_root yum install -y python3-pip
elif command -v apk >/dev/null 2>&1; then
run_root apk add --no-cache python3 py3-pip
else
return 1
fi
;;
*) return 1 ;;
esac
}
if [ ! -x "$VENV_PY" ]; then
log "==> 创建虚拟环境:.venv"
if ! "$PY_SYS" -m venv "$VENV_DIR" >/tmp/dms_venv.log 2>&1; then
warn "创建虚拟环境失败,尝试补齐 python3-venv ..."
install_venv_support || true
# 删掉半成品再重试,否则 venv 会认为目录已存在但不可用
case "$VENV_DIR" in
*/.venv)
if [ -d "$VENV_DIR" ]; then rm -rf "$VENV_DIR"; fi
;;
esac
if ! "$PY_SYS" -m venv "$VENV_DIR"; then
warn "虚拟环境创建失败,日志见 /tmp/dms_venv.log"
die "请手动安装 venv 支持后重试:
Ubuntu/Debian : sudo apt install -y python3-venv
RHEL/openEuler : sudo dnf install -y python3-pip
或者删掉 .venv 后重跑 ./scripts/run.sh"
fi
fi
if is_windows; then VENV_PY="$VENV_DIR/Scripts/python.exe"; else VENV_PY="$VENV_DIR/bin/python"; fi
fi
log " 虚拟环境:$VENV_PY"
DEPS_CHECK='import fastapi, uvicorn, sqlalchemy, pydantic, httpx, openpyxl, multipart'
deps_ok() { "$VENV_PY" -c "$DEPS_CHECK" >/dev/null 2>&1; }
install_deps() {
local indexes=() idx args
if ! "$VENV_PY" -m pip --version >/dev/null 2>&1; then
log "==> 虚拟环境里没有 pip,尝试 ensurepip 补齐"
"$VENV_PY" -m ensurepip --upgrade >/dev/null 2>&1 ||
die "虚拟环境缺少 pip,请删掉 .venv 后重跑 ./scripts/run.sh"
fi
if [ -n "$PIP_INDEX_URL" ]; then
indexes=("$PIP_INDEX_URL")
else
# 先尊重本机 pip 配置,失败再换国内镜像
indexes=("" "https://pypi.tuna.tsinghua.edu.cn/simple" "https://mirrors.aliyun.com/pypi/simple")
fi
for idx in "${indexes[@]}"; do
args=(install --disable-pip-version-check --timeout 20 --retries 2 -r requirements.txt)
if [ -n "$idx" ]; then
args+=(-i "$idx")
log "==> 安装依赖:$idx"
else
log "==> 安装依赖(pip 默认源)"
fi
if "$VENV_PY" -m pip "${args[@]}"; then
return 0
fi
warn "该源安装失败,换下一个源重试"
done
return 1
}
REQ_HASH="$(cksum requirements.txt 2>/dev/null | awk '{print $1 "-" $2}')"
DEPS_STAMP="$VENV_DIR/.requirements.cksum"
NEED_INSTALL=0
if ! deps_ok; then
NEED_INSTALL=1
elif [ ! -f "$DEPS_STAMP" ] || [ "$(cat "$DEPS_STAMP" 2>/dev/null)" != "$REQ_HASH" ]; then
# requirements.txt 变过(新增/升级依赖)时重装一次;pip 本身是幂等的
NEED_INSTALL=1
fi
if [ "$NEED_INSTALL" = "1" ]; then
log "==> 安装/更新运行依赖(首次约 1~2 分钟)"
if ! install_deps; then
die "依赖安装失败。可以手动执行:
$VENV_PY -m pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
或指定镜像:PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple ./scripts/run.sh"
fi
deps_ok || die "依赖装完仍无法 import,请检查 requirements.txt 与 Python 版本"
printf '%s\n' "$REQ_HASH" > "$DEPS_STAMP"
fi
log " 依赖检查:OK"
# ---------- 5. 首次运行:建表 + 预置分类 ----------
if [ ! -f data/board.db ]; then
log "==> 首次运行,初始化数据库"
"$VENV_PY" scripts/init_db.py
fi
# ---------- 6. 启动 ----------
RELOAD_ARGS=()
if [ "$DEV" = "1" ]; then
RELOAD_ARGS=(--reload
--reload-include "*.js" --reload-include "*.css" --reload-include "*.html"
--reload-include ".env")
fi
open_url() {
local url="$1"
[ "$NO_OPEN" = "1" ] && return 0
case "$(uname -s)" in
Darwin)
open "$url" >/dev/null 2>&1 || true
;;
Linux)
if [ -n "${DISPLAY:-}${WAYLAND_DISPLAY:-}" ] && command -v xdg-open >/dev/null 2>&1; then
xdg-open "$url" >/dev/null 2>&1 || true
fi
;;
MINGW*|MSYS*|CYGWIN*)
cmd.exe /c start "" "$url" >/dev/null 2>&1 || true
;;
esac
}
URL="http://127.0.0.1:${PORT}"
echo "==> 启动服务: $URL"
echo " API 文档: $URL/api/docs"
echo " 热更新: $([ "$DEV" = "1" ] && echo 开启 || echo 关闭)"
echo " 停止服务: Ctrl+C"
echo
if [ "$NO_OPEN" != "1" ]; then
( sleep 3; open_url "$URL" ) &
fi
exec "$VENV_PY" -m uvicorn app.main:app --host 127.0.0.1 --port "$PORT" \
${RELOAD_ARGS[@]+"${RELOAD_ARGS[@]}"}