start.sh 7.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313
  1. #!/bin/bash
  2. # ============================================
  3. # 安建医院纪检反馈系统 Backend 启动脚本
  4. # 用法: ./start.sh [选项]
  5. # ============================================
  6. set -euo pipefail
  7. RED='\033[0;31m'
  8. GREEN='\033[0;32m'
  9. YELLOW='\033[1;33m'
  10. BLUE='\033[0;34m'
  11. NC='\033[0m'
  12. HOST="${HOST:-0.0.0.0}"
  13. PORT="${PORT:-8000}"
  14. WORKERS="${WORKERS:-1}"
  15. RELOAD=false
  16. LOG_LEVEL="${LOG_LEVEL:-info}"
  17. FOREGROUND=false
  18. SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
  19. BACKEND_DIR="$SCRIPT_DIR"
  20. VENV_DIR="$BACKEND_DIR/venv"
  21. PYTHON="$VENV_DIR/bin/python"
  22. PIP="$VENV_DIR/bin/pip"
  23. UVICORN="$VENV_DIR/bin/uvicorn"
  24. LOG_DIR="$BACKEND_DIR/logs"
  25. LOG_FILE="$LOG_DIR/app.log"
  26. PID_FILE="$BACKEND_DIR/app.pid"
  27. log_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
  28. log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
  29. log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
  30. log_success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
  31. show_help() {
  32. cat << EOF
  33. 安建医院纪检反馈系统 Backend 启动脚本
  34. 用法: $0 [选项]
  35. 选项:
  36. -h, --host <ip> 监听地址 (默认: 0.0.0.0)
  37. -p, --port <port> 监听端口 (默认: 8000)
  38. -w, --workers <n> 工作进程数 (默认: 1;与 --reload 互斥)
  39. -r, --reload 开发模式,代码变更自动重载(前台运行)
  40. -f, --foreground 前台运行(不加则后台 + PID/日志)
  41. -l, --log-level <lv> 日志级别: debug/info/warning/error (默认: info)
  42. --install 创建 venv 并安装 requirements.txt
  43. --init 检查 Python / venv / .env
  44. --stop 停止后台服务
  45. --restart 重启后台服务
  46. --status 查看服务状态
  47. --logs [-f] 查看日志(-f 跟踪)
  48. --help 显示帮助
  49. 示例:
  50. $0 --reload # 本地开发(前台 + 热重载)
  51. $0 # 后台启动
  52. $0 --port 8001 --workers 2 # 指定端口与进程数
  53. $0 --stop
  54. $0 --logs -f
  55. EOF
  56. }
  57. check_python() {
  58. if ! command -v python3 >/dev/null 2>&1; then
  59. log_error "未找到 python3,请先安装 Python 3.9+"
  60. exit 1
  61. fi
  62. local ver
  63. ver="$(python3 -c 'import sys; print(".".join(map(str, sys.version_info[:2])))')"
  64. log_info "Python 版本: $ver"
  65. }
  66. create_venv() {
  67. log_info "创建虚拟环境: $VENV_DIR"
  68. python3 -m venv "$VENV_DIR"
  69. log_success "虚拟环境已创建"
  70. }
  71. install_dependencies() {
  72. check_python
  73. if [ ! -d "$VENV_DIR" ]; then
  74. create_venv
  75. fi
  76. # shellcheck disable=SC1091
  77. source "$VENV_DIR/bin/activate"
  78. log_info "升级 pip..."
  79. "$PIP" install --upgrade pip
  80. log_info "安装依赖..."
  81. "$PIP" install -r "$BACKEND_DIR/requirements.txt"
  82. log_success "依赖安装完成"
  83. }
  84. ensure_env_file() {
  85. if [ -f "$BACKEND_DIR/.env" ]; then
  86. return 0
  87. fi
  88. if [ -f "$BACKEND_DIR/.env.example" ]; then
  89. cp "$BACKEND_DIR/.env.example" "$BACKEND_DIR/.env"
  90. log_warn "已从 .env.example 生成 .env,请按环境修改数据库与 MinIO 配置"
  91. else
  92. log_error "缺少 .env 与 .env.example"
  93. exit 1
  94. fi
  95. }
  96. check_env() {
  97. if [ ! -d "$VENV_DIR" ]; then
  98. log_warn "虚拟环境不存在,正在创建并安装依赖..."
  99. install_dependencies
  100. fi
  101. if ! "$PYTHON" -c "import fastapi" >/dev/null 2>&1; then
  102. log_warn "依赖不完整,正在安装..."
  103. install_dependencies
  104. fi
  105. if [ ! -x "$UVICORN" ]; then
  106. log_error "未找到 uvicorn: $UVICORN"
  107. exit 1
  108. fi
  109. ensure_env_file
  110. }
  111. setup_logs() {
  112. mkdir -p "$LOG_DIR"
  113. }
  114. is_running() {
  115. if [ ! -f "$PID_FILE" ]; then
  116. return 1
  117. fi
  118. local pid
  119. pid="$(cat "$PID_FILE")"
  120. if ps -p "$pid" >/dev/null 2>&1; then
  121. return 0
  122. fi
  123. rm -f "$PID_FILE"
  124. return 1
  125. }
  126. start_server() {
  127. check_python
  128. check_env
  129. cd "$BACKEND_DIR"
  130. # shellcheck disable=SC1091
  131. source "$VENV_DIR/bin/activate"
  132. if [ "$RELOAD" = true ]; then
  133. FOREGROUND=true
  134. fi
  135. if [ "$FOREGROUND" != true ] && is_running; then
  136. log_error "服务已在运行 (PID: $(cat "$PID_FILE")),请先 ./start.sh --stop"
  137. exit 1
  138. fi
  139. local cmd=("$UVICORN" "app.main:app" "--host" "$HOST" "--port" "$PORT" "--log-level" "$LOG_LEVEL")
  140. if [ "$RELOAD" = true ]; then
  141. cmd+=(--reload)
  142. log_info "启动模式: 开发(热重载,前台)"
  143. else
  144. cmd+=(--workers "$WORKERS")
  145. log_info "启动模式: 后台(workers=${WORKERS})"
  146. fi
  147. log_info "=========================================="
  148. log_info " ajyy Backend 启动中"
  149. log_info " 地址: http://${HOST}:${PORT}"
  150. log_info " 文档: http://127.0.0.1:${PORT}/docs"
  151. log_info " 健康: http://127.0.0.1:${PORT}/api/health"
  152. log_info "=========================================="
  153. if [ "$FOREGROUND" = true ]; then
  154. exec "${cmd[@]}"
  155. fi
  156. setup_logs
  157. {
  158. echo "========================================"
  159. echo "启动时间: $(date '+%Y-%m-%d %H:%M:%S')"
  160. echo "命令: ${cmd[*]}"
  161. echo "========================================"
  162. } >>"$LOG_FILE"
  163. nohup "${cmd[@]}" >>"$LOG_FILE" 2>&1 &
  164. echo $! >"$PID_FILE"
  165. sleep 2
  166. if is_running; then
  167. log_success "服务启动成功 (PID: $(cat "$PID_FILE"))"
  168. log_info "日志: $LOG_FILE"
  169. else
  170. log_error "启动失败,请查看日志: $LOG_FILE"
  171. rm -f "$PID_FILE"
  172. exit 1
  173. fi
  174. }
  175. stop_server() {
  176. if [ ! -f "$PID_FILE" ]; then
  177. log_warn "PID 文件不存在,服务可能未运行"
  178. exit 0
  179. fi
  180. local pid
  181. pid="$(cat "$PID_FILE")"
  182. if ! ps -p "$pid" >/dev/null 2>&1; then
  183. log_warn "进程不存在 (PID: $pid),清理 PID 文件"
  184. rm -f "$PID_FILE"
  185. exit 0
  186. fi
  187. log_info "停止服务 (PID: $pid)..."
  188. kill -TERM "$pid" 2>/dev/null || true
  189. for _ in $(seq 1 10); do
  190. if ! ps -p "$pid" >/dev/null 2>&1; then
  191. break
  192. fi
  193. sleep 1
  194. done
  195. if ps -p "$pid" >/dev/null 2>&1; then
  196. log_warn "优雅退出超时,强制结束"
  197. kill -9 "$pid" 2>/dev/null || true
  198. fi
  199. rm -f "$PID_FILE"
  200. log_success "服务已停止"
  201. }
  202. show_status() {
  203. if is_running; then
  204. echo -e "${GREEN}[RUNNING]${NC} PID=$(cat "$PID_FILE") port=$PORT"
  205. if command -v lsof >/dev/null 2>&1; then
  206. lsof -i ":$PORT" 2>/dev/null | grep LISTEN || true
  207. fi
  208. else
  209. echo -e "${YELLOW}[STOPPED]${NC} 服务未运行"
  210. fi
  211. }
  212. show_logs() {
  213. if [ ! -f "$LOG_FILE" ]; then
  214. log_error "日志不存在: $LOG_FILE"
  215. exit 1
  216. fi
  217. if [ "${1:-}" = "-f" ] || [ "${1:-}" = "--follow" ]; then
  218. log_info "跟踪日志 (Ctrl+C 退出)..."
  219. tail -f "$LOG_FILE"
  220. else
  221. echo -e "${BLUE}=== 最近 100 行 ===${NC}"
  222. tail -100 "$LOG_FILE"
  223. fi
  224. }
  225. restart_server() {
  226. if is_running || [ -f "$PID_FILE" ]; then
  227. stop_server || true
  228. sleep 1
  229. fi
  230. start_server
  231. }
  232. ACTION="start"
  233. LOG_FOLLOW=""
  234. while [[ $# -gt 0 ]]; do
  235. case "$1" in
  236. -h|--host) HOST="$2"; shift 2 ;;
  237. -p|--port) PORT="$2"; shift 2 ;;
  238. -w|--workers) WORKERS="$2"; shift 2 ;;
  239. -r|--reload) RELOAD=true; shift ;;
  240. -f|--foreground) FOREGROUND=true; shift ;;
  241. -l|--log-level) LOG_LEVEL="$2"; shift 2 ;;
  242. --install) ACTION="install"; shift ;;
  243. --init) ACTION="init"; shift ;;
  244. --stop) ACTION="stop"; shift ;;
  245. --restart) ACTION="restart"; shift ;;
  246. --status) ACTION="status"; shift ;;
  247. --logs)
  248. ACTION="logs"
  249. shift
  250. if [[ "${1:-}" == "-f" || "${1:-}" == "--follow" ]]; then
  251. LOG_FOLLOW="-f"
  252. shift
  253. fi
  254. ;;
  255. --help) show_help; exit 0 ;;
  256. *)
  257. log_error "未知参数: $1"
  258. show_help
  259. exit 1
  260. ;;
  261. esac
  262. done
  263. case "$ACTION" in
  264. install) install_dependencies ;;
  265. init)
  266. check_python
  267. check_env
  268. log_success "环境检查完成"
  269. ;;
  270. stop) stop_server ;;
  271. restart) restart_server ;;
  272. status) show_status ;;
  273. logs) show_logs "$LOG_FOLLOW" ;;
  274. start) start_server ;;
  275. *)
  276. log_error "未知动作: $ACTION"
  277. exit 1
  278. ;;
  279. esac