基于 Flask 与 Airflow 的定时任务调度管理中心，提供 Web 管理后台，以及 server（管理后台）/ scheduler/webserver/worker/flower（Airflow 各角色）/coin（行情下载）等长期运行服务。
uv add funcron
# 或
pip install funcron安装完成后，基于 Typer 的 funcron 命令行提供两个查询类子命令：
# 查看本机常用服务端口的可访问状态
funcron status
# 列出 scripts/setup.sh 支持托管的服务名
funcron services长期运行服务的启停不走 CLI，统一由 scripts/setup.sh 管理，见下一节。
生产环境或本地长期运行各服务，统一通过 scripts/setup.sh 管理。先安装所需版本，再按 动作 → 服务 解析运行参数：
# 用法: scripts/setup.sh {start|stop|restart|run|status} <service>
# <service>: server | airflow-webserver | airflow-scheduler | airflow-worker
# | airflow-flower | coin | all
# 构建并安装当前源码，然后后台启动 Web 管理后台
scripts/setup.sh install-dev
scripts/setup.sh start server
# 生产机可安装指定正式版本
scripts/setup.sh install-prod 0.5.9
# 前台运行 Airflow scheduler，方便调试
scripts/setup.sh run airflow-scheduler
# 查看所有服务状态
scripts/setup.sh status allstart/stop/restart 管理后台进程，run 是前台阻塞运行，方便调试单个服务，不支持 all。
运行命令不接受 dev/prod 参数；当前安装的是本地构建还是正式版本，分别由
install-dev 和 install-prod [version] 决定。
PID、进程身份记录与日志统一放在仓库根目录的 .run/ 下（按服务名区分）。重复启动检查会
校验 PID 对应进程的启动时刻与命令特征：进程已退出的陈旧 PID 文件会被清理后继续启动；PID 已被
其他进程复用时拒绝操作并提示人工确认，不会误杀无关进程。
运行服务要求 funcron / airflow / funcoin 已安装为非 editable 包：校验会清空 PYTHONPATH、用
Python 隔离模式导入，并断言模块文件落在 site-packages 下，因此 editable 安装（pip install -e、
uv sync）或直接从源码工作树运行都会被拒绝；gunicorn 的配置文件也从已安装包内解析，
不引用仓库源码。
仓库内不保存 airflow.cfg：配置文件一旦写上元数据库连接串，账号密码就会随版本库和
PyPI 包一起发出去；而 Airflow 的 dags_folder / plugins_folder / base_log_folder
必须是绝对路径，写进包里就只在某一台机器上成立。
funcron 需要覆盖的配置项统一由 scripts/lib/funcron-airflow-env.sh 以
AIRFLOW__<SECTION>__<KEY> 环境变量注入，取值顺序为
「调用方已导出的环境变量 → .env 文件 → 按运行环境推导的默认值」：
| 配置项 | dev 默认值 | prod 默认值 |
|---|---|---|
AIRFLOW_HOME |
.run/airflow-dev-home |
$AIRFLOW_HOME_PROD（默认 $HOME/airflow） |
AIRFLOW__CORE__DAGS_FOLDER |
源码树 src/funcron/airflow/dags |
已安装 funcron 包内的 airflow/dags |
AIRFLOW__CORE__PLUGINS_FOLDER |
$AIRFLOW_HOME/plugins |
同左 |
AIRFLOW__LOGGING__BASE_LOG_FOLDER |
$AIRFLOW_HOME/logs |
同左 |
AIRFLOW__DATABASE__SQL_ALCHEMY_CONN |
不设置（回落到 AIRFLOW_HOME 下的 SQLite） |
必填，缺失直接拒绝启动 |
凭据写在仓库根目录的 .env（不进版本库），模板见 .env.example；也可用
FUNCRON_ENV_FILE 指向别处。
首次部署先初始化元数据库，再按上一节启动各角色服务：
scripts/airflow-init.sh prod
scripts/setup.sh start airflow-scheduler管理员账号由所选 auth manager 负责创建（Airflow 3 默认的 SimpleAuthManager 用
AIRFLOW__CORE__SIMPLE_AUTH_MANAGER_USERS 配置；装了 apache-airflow-providers-fab
时用 airflow fab-manager create-user），funcron 不再自带建账号脚本。
airflow-webserver 服务底层执行的是 airflow api-server——Airflow 3 已移除
airflow webserver 子命令，承载 Web UI 的组件改名为 api-server；对外的服务名保持不变。
数据库密码、Web 登录密码、Redis 密码、通知 API key、API access token、Flask session key
均从 funsecret 读取，不提供默认凭据。对应路径位于 funcron/database/mysql/password、
funcron/web/login/password、funcron/redis/password、funcron/notice/error_api_key、
funcron/api/access_token 和 funcron/web/flask/secret_key。缺少登录密码时 Web 登录会拒绝访问；
缺少 API access token 时 API 会返回配置错误；可选的 Redis 密码和通知 API key 为空时不启用相应认证或通知。
Flask 配置名可取 development / testing / production / default，由 create_app(config_name)
显式选择。只有 development 会开启 DEBUG；default 指向生产配置，testing 只开 TESTING。
数据库文件、日志与中间文件放在工作目录下，按以下顺序解析：FUNCRON_APP_DIR 环境变量 →
FUNDATA_APP_DIR 环境变量 → /opt/farfarfun/apps/funcron（当前用户可写时）→ ~/.funcron。
显式设置环境变量时按设置值使用，不再做可写性回落。
uv sync
uv run pytest
uv run ruff check
uv run ruff format --check源码采用 src 布局（src/funcron/），因此在仓库根目录直接 import funcron 不会命中工作树，
需要先 uv sync 安装。
farfarfun 是一个专注于实用工具库的开源组织， 涵盖云存储、数据处理、AI、多媒体与开发工具链等方向。
- 🏠 组织主页：https://github.com/farfarfun
- 📦 PyPI：https://pypi.org/user/niuliangtao/
- 📧 联系：farfarfun@qq.com
本项目基于 MIT 协议开源。