Mathesar安装与配置指南

Mathesar安装与配置指南

mathesar An intuitive spreadsheet-like interface that lets users of all technical skill levels view, edit, query, and collaborate on Postgres data directly—100% open source and self hosted, with native Postgres access control. 项目地址: https://gitcode.com/gh_mirrors/ma/mathesar

1. 项目基础介绍

Mathesar是一个开源项目，旨在为用户提供一个直观的电子表格式界面，以方便用户查看、编辑、查询和协作PostgreSQL数据库中的数据。该项目由Mathesar Foundation维护，使用户无需编写代码即可操作数据库。Mathesar完全开源，并可以自行托管，支持原生PostgreSQL访问控制。

主要编程语言：Python

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

• Django: 一个高级的Python Web框架，用于快速开发安全且易于维护的网站。
• PostgreSQL: 一个功能强大的开源对象关系型数据库系统。
• Docker: 用于打包和运行应用的平台，使得部署应用更为简便。

3. 安装和配置准备工作

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

• Python 3.7+：Mathesar需要Python 3.7或更高版本。
• Docker：用于容器化部署Mathesar。
• PostgreSQL：数据库系统，Mathesar将使用它来存储数据。
• Git：用于从GitHub克隆Mathesar源代码。

确保上述所有工具都已安装在您的系统上。

安装步骤

克隆项目

首先，您需要从GitHub克隆Mathesar项目：

git clone https://github.com/mathesar-foundation/mathesar.git
cd mathesar

安装依赖

接着，安装项目所需的Python依赖：

pip install -r requirements.txt

设置环境变量

在项目根目录中创建一个.env文件，并添加以下环境变量：

DATABASE_URL="postgres://username:password@localhost:5432/mathesar"
SECRET_KEY="your-secret-key"
DEBUG=True

请将username和password替换为您的PostgreSQL登录凭证。

初始化数据库

使用以下命令来创建数据库和迁移：

python manage.py makemigrations
python manage.py migrate

运行开发服务器

现在，您可以使用以下命令启动Mathesar的开发服务器：

python manage.py runserver

然后，在浏览器中访问http://127.0.0.1:8000，您应该能够看到Mathesar的界面。

使用Docker

如果您希望使用Docker来部署Mathesar，您需要构建Docker镜像并运行容器。以下是基本的步骤：

1. 构建Docker镜像：

docker build -t mathesar .

2. 运行Mathesar容器：

docker run -p 8000:8000 mathesar

然后，在浏览器中访问http://127.0.0.1:8000。

恭喜！您现在已经成功安装和配置了Mathesar。请按照项目文档继续探索更多功能。

mathesar An intuitive spreadsheet-like interface that lets users of all technical skill levels view, edit, query, and collaborate on Postgres data directly—100% open source and self hosted, with native Postgres access control. 项目地址: https://gitcode.com/gh_mirrors/ma/mathesar