开源项目Libredesk安装与配置指南

开源项目Libredesk安装与配置指南

libredesk Open source, self-hosted customer support desk. Single binary app. 项目地址: https://gitcode.com/gh_mirrors/li/libredesk

1. 项目基础介绍

Libredesk 是一个开源的自托管客户支持平台，提供了一个简单易用的界面来管理客户支持工单。它是一个单一的二进制应用程序，旨在帮助团队轻松管理跨团队的对话。该项目目前处于 alpha 阶段，因此功能和服务接口可能会发生变化。

主要编程语言

• 后端：Go
• 前端：Vue.js

2. 项目使用的关键技术和框架

• 后端技术：使用 Go 语言开发，具有高性能和简洁的代码特点。
• 前端框架：基于 Vue.js 3，搭配 Shadcn UI 组件库，提供现代和响应式的用户界面。
• 数据库：使用 PostgreSQL 进行数据存储。
• 自动化测试：通过 GitHub Actions 实现自动化测试流程。
• 容器化部署：支持 Docker 和 Docker Compose 进行容器化部署。

3. 项目安装和配置的准备工作

在开始安装之前，请确保您的系统满足以下要求：

• 操作系统：Linux 或 macOS
• Go 语言：安装 Go 1.16 或更高版本
• Docker：安装 Docker 和 Docker Compose
• PostgreSQL：安装 PostgreSQL 数据库

详细安装步骤

使用 Docker 和 Docker Compose

1. 克隆项目仓库到本地：

   git clone https://github.com/abhinavxd/libredesk.git
   cd libredesk
   

2. 下载 Docker Compose 文件和配置文件样本：

   curl -LO https://github.com/abhinavxd/libredesk/raw/main/docker-compose.yml
   curl -LO https://github.com/abhinavxd/libredesk/raw/main/config.sample.toml
   

3. 复制配置文件样本并编辑：

   cp config.sample.toml config.toml
   

4. 编辑 config.toml 文件，取消注释包含 "docker compose" 的行，并用服务名替换 IP 地址。

5. 启动 Docker 服务：

   docker compose up -d
   

6. 设置系统用户密码：

   docker exec -it libredesk_app ./libredesk --set-system-user-password
   

7. 在浏览器中访问 http://localhost:9000 并使用设置的密码登录。

使用二进制文件

1. 下载最新版本的二进制文件并解压。

2. 复制 config.sample.toml 到 config.toml 并根据需要进行编辑。

3. 运行以下命令来设置数据库：

   ./libredesk --install
   

   如果是升级现有数据库，使用：

   ./libredesk --upgrade
   

4. 设置系统用户密码：

   ./libredesk --set-system-user-password
   

5. 运行应用程序：

   ./libredesk
   

6. 在浏览器中访问 http://localhost:9000 并使用设置的密码登录。

以上就是 Libredesk 的详细安装和配置指南。请按照以上步骤进行操作，祝您安装顺利！

libredesk Open source, self-hosted customer support desk. Single binary app. 项目地址: https://gitcode.com/gh_mirrors/li/libredesk