最完整的Logto入门指南：从安装到部署全程详解

你还在为日志管理系统的复杂配置头疼吗？是否需要一个开箱即用的日志收集分析工具？本文将带你从零开始，用10分钟快速掌握Logto的安装、配置与部署全流程，让你轻松实现日志数据的可视化管理。

一、Logto是什么？

Logto是一款开源的日志管理Web工具，支持多格式日志收集、实时分析和可视化展示。其核心优势在于：

• 无需复杂编码，通过控制台即可完成配置
• 内置20+种数据连接器，支持主流数据库与云服务
• 提供直观的操作界面和详细的官方文档

二、3步完成本地安装

1. 准备环境

确保已安装Docker和Docker Compose，直接使用项目提供的docker-compose.yml配置文件：

# 核心服务配置示例
services:
  api:
    build: ./packages/api
    ports:
      - "3000:3000"
  db:
    image: postgres:14

2. 克隆代码库

git clone https://gitcode.com/gh_mirrors/lo/logto
cd logto

3. 启动服务

docker-compose up -d

等待30秒后访问 http://localhost:3000 即可看到登录界面。

三、基础配置指南

首次登录

使用默认账号[e-mail]和密码logto123登录管理控制台，首次登录将引导完成：

• 组织信息设置
• 数据存储配置
• 日志源添加

添加日志源

在控制台左侧菜单选择「日志源」→「添加」，根据日志类型选择对应连接器：

• 文件日志：选择File Connector
• 数据库日志：选择对应数据库连接器（如MySQL）
• 云服务日志：支持AWS CloudWatch等10+种云服务

四、部署到生产环境

推荐部署方案

项目提供多种部署选项：

• Docker Compose：适合中小规模应用
• Render部署配置：一键部署到云服务
• Kubernetes：参考部署文档

安全最佳实践

1. 修改默认密码：通过CLI工具执行logto auth change-password
2. 配置HTTPS：在API服务配置中设置TLS证书
3. 数据备份：启用自动备份功能

五、常见问题解决

服务启动失败？

检查端口占用情况，默认使用3000（API）、5432（数据库）端口，可在docker-compose.yml中修改。

日志不显示？

1. 检查日志源配置是否正确
2. 查看API服务日志排查错误
3. 确认数据连接器状态正常

六、下一步学习

• 查看开发指南了解自定义开发
• 探索演示应用学习集成方法
• 加入社区：GitHub Discussions

通过以上步骤，你已掌握Logto的核心使用方法。如需深入功能，可参考高级配置文档或API文档。