perdian/flightlog

Flightlog 中文文档

概述

Flightlog 是一款用于跟踪个人航班记录的工具，旨在解决现有航班记录平台（如 flugstatistik.de、Openflights.org）存在的UI过时、数据备份缺失、功能不足等问题。该工具采用现代简洁的UI设计，整合了传统平台的核心思路并进行优化，支持数据本地存储与备份，避免供应商锁定风险。

!https://github.com/perdian/flightlog/raw/v2.1.10/docs/screenshots/home.png

核心功能与特性

• 现代UI设计：整合传统平台优点，界面更简洁、现代化
• 数据自主管理：支持本地数据库存储，避免数据锁定
• 多认证方式：支持无认证（单用户模式）、OAuth2（Google及通用提供商）、LDAP认证
• 灵活配置：通过环境变量自定义数据库、端口、上下文路径等参数
• Docker部署：提供Docker镜像，简化安装与运行流程

使用场景

适用于需要跟踪个人航班记录、注重数据安全性与可备份性、对界面体验有现代需求的用户。尤其适合希望摆脱第三方平台依赖，自主管理航班数据的个人用户。

安装与使用

Docker容器部署

基本运行

通过Docker Hub获取镜像并启动容器，是部署Flightlog最简便的方式：

bash
docker run -p 8080:8080 perdian/flightlog:latest

建议将latest替换为最新版本，版本信息可在https://github.com/perdian/flightlog/releases%E6%9F%A5%E8%AF%A2%E3%80%82

容器启动后，应用可通过以下地址访问： http://localhost:8080/flightlog/

数据持久化

默认使用嵌入式H2数据库，数据存储于容器内/var/flightlog/database/目录。为持久化数据，需将该目录挂载至主机：

bash
docker run -v /path/to/host/directory:/var/flightlog/database -p 8080:8080 perdian/flightlog

配置说明

数据库配置

支持H2（默认）、PostgreSQL、MySQL等数据库，通过环境变量配置：

认证配置

默认单用户模式（无认证）

默认无需认证，所有航班记录关联至默认用户example@example.com。可通过以下变量修改默认用户***：

bash
FLIGHTLOG_AUTHENTICATION_FIXED_DEFAULT_EMAIL_ADDRESS=your.email@example.com

OAuth2认证

支持通过OAuth2提供商（如Google、通用OAuth2服务）认证，需设置：

bash
FLIGHTLOG_AUTHENTICATION_TYPE=OAUTH2

Google OAuth2配置

需从Google Cloud控制台获取凭据，并设置：

• FLIGHTLOG_AUTHENTICATION_OAUTH2_GOOGLE_CLIENT_ID：客户端ID
• FLIGHTLOG_AUTHENTICATION_OAUTH2_GOOGLE_CLIENT_SECRET：客户端密钥

需在Google Cloud控制台配置重定向URL：<应用根路径>/login/oauth2/code/flightlog
示例：若应用地址为http://localhost:8080/flightlog/，则重定向URL为http://localhost:8080/flightlog/login/oauth2/code/flightlog

通用OAuth2配置

支持其他OAuth2提供商（如Authentik），需配置以下变量：

LDAP认证

通过LDAP服务器认证，需设置：

bash
FLIGHTLOG_AUTHENTICATION_TYPE=LDAP

并配置以下变量：

用户注册白名单

默认禁止新用户注册，可通过以下方式允许：

允许所有用户注册

bash
FLIGHTLOG_REGISTRATION_ALLOW_BY_DEFAULT=true

指定允许的用户名

通过逗号分隔的用户名列表配置白名单：

bash
FLIGHTLOG_REGISTRATION_USERNAMES_ALLOWLIST=user1,user2@example.com

历史兼容变量FLIGHTLOG_REGISTRATION_EMAIL_ADDRESSES_ALLOWLIST会与上述列表合并（仅当认证提供商返回的用户名为***时生效）。

其他环境变量

从源码构建与运行

构建JAR文件

Flightlog基于Spring Boot开发，可通过Maven构建：

bash
git clone https://github.com/perdian/flightlog.git
cd flightlog
mvn clean package

构建后的JAR文件位于target/flightlog.jar。

运行JAR文件

bash
java -jar target/flightlog.jar

默认访问地址：http://localhost:8080/flightlog/，H2数据库存储于~/.flightlog/。

构建Docker镜像

从源码构建Docker镜像：

bash
mvn clean package
docker build -t perdian/flightlog .

致谢

Flightlog的开发依赖以下开源项目：

• Openflights.org（机场和航空公司数据）
• Openlayers（地图展示）
• arc.js（大圆航线计算）
• Semantic UI（前端组件）
• JQuery（DOM操作）
• Spring Boot（后端框架）
• Hibernate（ORM框架）

许可证

Flightlog采用Apache License 2.0许可协议（<[***]>）。