Initial commit: secondary school grade archive system.
Add FastAPI/React app with Docker deployment, Ubuntu one-click install, and docs for junior/senior high score tracking and mistake bank. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
dekun
@@ -0,0 +1,25 @@
|
||||
#!/usr/bin/env bash
|
||||
#
|
||||
# 备份 PostgreSQL 与 uploads 目录
|
||||
# 版权所有 (c) 马建军
|
||||
#
|
||||
set -euo pipefail
|
||||
|
||||
INSTALL_DIR="${INSTALL_DIR:-/opt/secondary-school-grade-archive}"
|
||||
BACKUP_DIR="${BACKUP_DIR:-${INSTALL_DIR}/backups}"
|
||||
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
|
||||
|
||||
cd "${INSTALL_DIR}"
|
||||
mkdir -p "${BACKUP_DIR}"
|
||||
|
||||
echo "[INFO] 备份数据库…"
|
||||
docker compose --env-file .env exec -T db \
|
||||
pg_dump -U "${POSTGRES_USER:-postgres}" "${POSTGRES_DB:-student_archive}" \
|
||||
> "${BACKUP_DIR}/db_${TIMESTAMP}.sql"
|
||||
|
||||
echo "[INFO] 备份 uploads…"
|
||||
tar -czf "${BACKUP_DIR}/uploads_${TIMESTAMP}.tar.gz" -C "${INSTALL_DIR}" uploads/
|
||||
|
||||
echo "[INFO] 备份完成:"
|
||||
echo " ${BACKUP_DIR}/db_${TIMESTAMP}.sql"
|
||||
echo " ${BACKUP_DIR}/uploads_${TIMESTAMP}.tar.gz"
|
||||
@@ -0,0 +1,231 @@
|
||||
#!/usr/bin/env bash
|
||||
#
|
||||
# 中学成绩档案系统 — Ubuntu 一键部署脚本
|
||||
# 版权所有 (c) 马建军 微信: dekun03 手机: 18364911125
|
||||
#
|
||||
# 用法（root）:
|
||||
# curl -fsSL .../deploy/install.sh | bash
|
||||
# 或
|
||||
# bash deploy/install.sh
|
||||
#
|
||||
set -euo pipefail
|
||||
|
||||
REPO_URL="${REPO_URL:-https://git.bz121.com/dekun/secondary-school-grade-archive.git}"
|
||||
INSTALL_DIR="${INSTALL_DIR:-/opt/secondary-school-grade-archive}"
|
||||
WEB_PORT="${WEB_PORT:-23566}"
|
||||
BRANCH="${BRANCH:-main}"
|
||||
|
||||
RED='\033[0;31m'
|
||||
GREEN='\033[0;32m'
|
||||
YELLOW='\033[1;33m'
|
||||
NC='\033[0m'
|
||||
|
||||
log_info() { echo -e "${GREEN}[INFO]${NC} $*"; }
|
||||
log_warn() { echo -e "${YELLOW}[WARN]${NC} $*"; }
|
||||
log_error() { echo -e "${RED}[ERROR]${NC} $*" >&2; }
|
||||
|
||||
require_root() {
|
||||
if [[ "${EUID:-$(id -u)}" -ne 0 ]]; then
|
||||
log_error "请使用 root 用户运行本脚本，例如: sudo bash deploy/install.sh"
|
||||
exit 1
|
||||
fi
|
||||
}
|
||||
|
||||
check_os() {
|
||||
if [[ ! -f /etc/os-release ]]; then
|
||||
log_error "无法识别操作系统，本脚本仅支持 Ubuntu/Debian 系 Linux"
|
||||
exit 1
|
||||
fi
|
||||
# shellcheck source=/dev/null
|
||||
source /etc/os-release
|
||||
log_info "检测到系统: ${NAME:-Unknown} ${VERSION_ID:-}"
|
||||
case "${ID:-}" in
|
||||
ubuntu|debian)
|
||||
;;
|
||||
*)
|
||||
log_warn "当前系统为 ${ID:-unknown}，未经完整测试，继续安装…"
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
check_resources() {
|
||||
local mem_kb disk_kb
|
||||
mem_kb=$(grep MemTotal /proc/meminfo | awk '{print $2}')
|
||||
disk_kb=$(df -k "${INSTALL_DIR%/*}" 2>/dev/null | tail -1 | awk '{print $4}')
|
||||
if [[ "${mem_kb:-0}" -lt 1800000 ]]; then
|
||||
log_warn "内存不足 2GB，PaddleOCR 首次运行可能较慢"
|
||||
fi
|
||||
if [[ "${disk_kb:-0}" -lt 5242880 ]]; then
|
||||
log_warn "可用磁盘空间不足 5GB，请确保有足够空间存放镜像与 OCR 模型"
|
||||
fi
|
||||
}
|
||||
|
||||
check_port() {
|
||||
if command -v ss &>/dev/null; then
|
||||
if ss -tln | grep -q ":${WEB_PORT} "; then
|
||||
log_error "端口 ${WEB_PORT} 已被占用，请修改 WEB_PORT 环境变量后重试"
|
||||
exit 1
|
||||
fi
|
||||
elif command -v netstat &>/dev/null; then
|
||||
if netstat -tln | grep -q ":${WEB_PORT} "; then
|
||||
log_error "端口 ${WEB_PORT} 已被占用"
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
log_info "端口 ${WEB_PORT} 可用"
|
||||
}
|
||||
|
||||
install_packages() {
|
||||
log_info "安装基础依赖…"
|
||||
apt-get update -qq
|
||||
apt-get install -y -qq git curl ca-certificates openssl
|
||||
}
|
||||
|
||||
install_docker() {
|
||||
if command -v docker &>/dev/null; then
|
||||
log_info "Docker 已安装: $(docker --version)"
|
||||
else
|
||||
log_info "正在安装 Docker…"
|
||||
apt-get install -y -qq apt-transport-https gnupg lsb-release
|
||||
install -m 0755 -d /etc/apt/keyrings
|
||||
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
|
||||
chmod a+r /etc/apt/keyrings/docker.asc
|
||||
echo \
|
||||
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
|
||||
$(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" \
|
||||
> /etc/apt/sources.list.d/docker.list
|
||||
apt-get update -qq
|
||||
apt-get install -y -qq docker-ce docker-ce-cli containerd.io docker-compose-plugin
|
||||
systemctl enable docker
|
||||
systemctl start docker
|
||||
log_info "Docker 安装完成"
|
||||
fi
|
||||
|
||||
if ! docker compose version &>/dev/null; then
|
||||
log_error "未检测到 docker compose 插件，请手动安装 docker-compose-plugin"
|
||||
exit 1
|
||||
fi
|
||||
log_info "Docker Compose: $(docker compose version)"
|
||||
}
|
||||
|
||||
clone_or_update_repo() {
|
||||
if [[ -d "${INSTALL_DIR}/.git" ]]; then
|
||||
log_info "更新代码: ${INSTALL_DIR}"
|
||||
git -C "${INSTALL_DIR}" fetch origin
|
||||
git -C "${INSTALL_DIR}" checkout "${BRANCH}" 2>/dev/null || true
|
||||
git -C "${INSTALL_DIR}" pull --ff-only origin "${BRANCH}" || git -C "${INSTALL_DIR}" pull origin "${BRANCH}"
|
||||
elif [[ -d "${INSTALL_DIR}" ]]; then
|
||||
log_error "目录 ${INSTALL_DIR} 已存在但不是 git 仓库，请备份后删除或修改 INSTALL_DIR"
|
||||
exit 1
|
||||
else
|
||||
log_info "克隆仓库到 ${INSTALL_DIR}"
|
||||
mkdir -p "$(dirname "${INSTALL_DIR}")"
|
||||
git clone --branch "${BRANCH}" "${REPO_URL}" "${INSTALL_DIR}" || git clone "${REPO_URL}" "${INSTALL_DIR}"
|
||||
fi
|
||||
}
|
||||
|
||||
generate_env() {
|
||||
local env_file="${INSTALL_DIR}/.env"
|
||||
local server_ip
|
||||
server_ip=$(hostname -I 2>/dev/null | awk '{print $1}')
|
||||
server_ip="${server_ip:-127.0.0.1}"
|
||||
|
||||
if [[ -f "${env_file}" ]]; then
|
||||
log_info "保留已有 .env 配置"
|
||||
# shellcheck source=/dev/null
|
||||
source "${env_file}"
|
||||
WEB_PORT="${WEB_PORT:-23566}"
|
||||
return
|
||||
fi
|
||||
|
||||
log_info "生成 .env 配置文件"
|
||||
local secret pg_pass
|
||||
secret=$(openssl rand -hex 32)
|
||||
pg_pass=$(openssl rand -hex 16)
|
||||
|
||||
cat > "${env_file}" <<EOF
|
||||
# 由 deploy/install.sh 自动生成 — $(date -Iseconds)
|
||||
WEB_PORT=${WEB_PORT}
|
||||
SECRET_KEY=${secret}
|
||||
POSTGRES_USER=postgres
|
||||
POSTGRES_PASSWORD=${pg_pass}
|
||||
POSTGRES_DB=student_archive
|
||||
CORS_ORIGINS=http://${server_ip}:${WEB_PORT},http://127.0.0.1:${WEB_PORT},http://localhost:${WEB_PORT}
|
||||
OLLAMA_BASE_URL=http://host.docker.internal:11434
|
||||
OLLAMA_MODEL=qwen2.5:7b
|
||||
FLUCTUATION_THRESHOLD=0.08
|
||||
EOF
|
||||
chmod 600 "${env_file}"
|
||||
log_info ".env 已写入 ${env_file}"
|
||||
}
|
||||
|
||||
start_services() {
|
||||
log_info "构建并启动 Docker 服务（首次可能需 10–30 分钟）…"
|
||||
cd "${INSTALL_DIR}"
|
||||
mkdir -p uploads backups
|
||||
docker compose --env-file .env pull 2>/dev/null || true
|
||||
docker compose --env-file .env up -d --build
|
||||
}
|
||||
|
||||
wait_healthy() {
|
||||
local i max=60
|
||||
log_info "等待 API 就绪…"
|
||||
for ((i=1; i<=max; i++)); do
|
||||
if docker compose --env-file "${INSTALL_DIR}/.env" exec -T api \
|
||||
python -c "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8000/api/health')" &>/dev/null; then
|
||||
log_info "API 健康检查通过"
|
||||
return 0
|
||||
fi
|
||||
sleep 3
|
||||
done
|
||||
log_warn "API 启动超时，请执行: cd ${INSTALL_DIR} && docker compose logs api"
|
||||
}
|
||||
|
||||
print_summary() {
|
||||
local ip
|
||||
ip=$(hostname -I 2>/dev/null | awk '{print $1}')
|
||||
ip="${ip:-127.0.0.1}"
|
||||
# shellcheck source=/dev/null
|
||||
source "${INSTALL_DIR}/.env"
|
||||
|
||||
echo ""
|
||||
echo "=========================================="
|
||||
echo " 中学成绩档案系统 部署完成"
|
||||
echo " 版权所有 (c) 马建军"
|
||||
echo "=========================================="
|
||||
echo ""
|
||||
echo " 访问地址: http://${ip}:${WEB_PORT}"
|
||||
echo " 本地访问: http://127.0.0.1:${WEB_PORT}"
|
||||
echo " 安装目录: ${INSTALL_DIR}"
|
||||
echo ""
|
||||
echo " 常用命令:"
|
||||
echo " 查看状态: cd ${INSTALL_DIR} && docker compose ps"
|
||||
echo " 查看日志: cd ${INSTALL_DIR} && docker compose logs -f"
|
||||
echo " 停止服务: cd ${INSTALL_DIR} && docker compose down"
|
||||
echo " 更新版本: bash ${INSTALL_DIR}/deploy/update.sh"
|
||||
echo " 数据备份: bash ${INSTALL_DIR}/deploy/backup.sh"
|
||||
echo ""
|
||||
echo " 反向代理（Nginx/Caddy 等）请自行配置，本项目不包含。"
|
||||
echo " 详见文档: ${INSTALL_DIR}/docs/DEPLOY.md"
|
||||
echo ""
|
||||
echo " 技术支持: 微信 dekun03 手机 18364911125"
|
||||
echo "=========================================="
|
||||
}
|
||||
|
||||
main() {
|
||||
echo ""
|
||||
log_info "中学成绩档案系统 — 一键部署开始"
|
||||
require_root
|
||||
check_os
|
||||
check_resources
|
||||
check_port
|
||||
install_packages
|
||||
install_docker
|
||||
clone_or_update_repo
|
||||
generate_env
|
||||
start_services
|
||||
wait_healthy
|
||||
print_summary
|
||||
}
|
||||
|
||||
main "$@"
|
||||
@@ -0,0 +1,28 @@
|
||||
#!/usr/bin/env bash
|
||||
#
|
||||
# 停止并移除容器（默认保留数据卷与 uploads）
|
||||
# 版权所有 (c) 马建军
|
||||
#
|
||||
set -euo pipefail
|
||||
|
||||
INSTALL_DIR="${INSTALL_DIR:-/opt/secondary-school-grade-archive}"
|
||||
REMOVE_VOLUMES="${REMOVE_VOLUMES:-0}"
|
||||
|
||||
cd "${INSTALL_DIR}" || exit 1
|
||||
|
||||
echo "将停止 Docker 服务…"
|
||||
if [[ "${REMOVE_VOLUMES}" == "1" ]]; then
|
||||
echo "警告: 将删除数据库卷（所有成绩数据会丢失）"
|
||||
read -r -p "确认删除数据卷? 输入 yes: " ans
|
||||
if [[ "${ans}" == "yes" ]]; then
|
||||
docker compose --env-file .env down -v
|
||||
else
|
||||
echo "已取消"
|
||||
exit 1
|
||||
fi
|
||||
else
|
||||
docker compose --env-file .env down
|
||||
echo "数据卷与 ${INSTALL_DIR}/uploads 已保留"
|
||||
fi
|
||||
|
||||
echo "卸载完成。源码目录 ${INSTALL_DIR} 未自动删除，如需删除请手动 rm -rf"
|
||||
@@ -0,0 +1,29 @@
|
||||
#!/usr/bin/env bash
|
||||
#
|
||||
# 更新已部署实例：拉取代码并重建容器
|
||||
# 版权所有 (c) 马建军
|
||||
#
|
||||
set -euo pipefail
|
||||
|
||||
INSTALL_DIR="${INSTALL_DIR:-/opt/secondary-school-grade-archive}"
|
||||
BRANCH="${BRANCH:-main}"
|
||||
|
||||
GREEN='\033[0;32m'
|
||||
NC='\033[0m'
|
||||
log_info() { echo -e "${GREEN}[INFO]${NC} $*"; }
|
||||
|
||||
if [[ ! -d "${INSTALL_DIR}/.git" ]]; then
|
||||
echo "未找到部署目录 ${INSTALL_DIR}，请先运行 deploy/install.sh"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
cd "${INSTALL_DIR}"
|
||||
log_info "拉取最新代码…"
|
||||
git fetch origin
|
||||
git checkout "${BRANCH}" 2>/dev/null || true
|
||||
git pull origin "${BRANCH}"
|
||||
|
||||
log_info "重建并重启服务…"
|
||||
docker compose --env-file .env up -d --build
|
||||
|
||||
log_info "更新完成。访问端口见 .env 中 WEB_PORT"
|
||||
Reference in New Issue
Block a user