mirror of
https://github.com/sosedoff/pgweb.git
synced 2024-12-15 20:13:06 +03:00
167 lines
3.7 KiB
Markdown
167 lines
3.7 KiB
Markdown
# pgweb
|
|
|
|
Web-based PostgreSQL database browser written in Go.
|
|
|
|
[](https://travis-ci.org/sosedoff/pgweb)
|
|
|
|
## Overview
|
|
|
|
This is a web-based browser for PostgreSQL database server. Its written in Go
|
|
and works on Mac OSX, Linux and Windows machines. Main idea behind using Go for the backend
|
|
is to utilize language's ability for cross-compile source code for multiple platforms.
|
|
This project is an attempt to create a very simple and portable application to work with
|
|
PostgreSQL databases.
|
|
|
|
<img src="screenshots/browse.png" width="345px" />
|
|
<img src="screenshots/query.png" width="345px" />
|
|
|
|
Features:
|
|
|
|
- Connect to local or remote server
|
|
- Browse tables and table rows
|
|
- Get table details: structure, size, indices, row count
|
|
- Execute SQL query and run analyze on it
|
|
- Export query results to CSV
|
|
- View query history
|
|
|
|
## Installation
|
|
|
|
Please visit [Github Releases](https://github.com/sosedoff/pgweb/releases) to download a
|
|
precompiled binary for your operating system.
|
|
|
|
Currently supported:
|
|
|
|
- Mac OSX 64bit
|
|
- Linux 32/64bit
|
|
- Windows 32/64bit
|
|
|
|
Supported PostgreSQL versions:
|
|
|
|
- 9.1
|
|
- 9.2
|
|
- 9.3
|
|
|
|
Older versions of PostgreSQL might also work but this project is not tested on
|
|
8.x branches.
|
|
|
|
## Run on Heroku
|
|
|
|
[](https://heroku.com/deploy?template=https://github.com/sosedoff/pgweb)
|
|
|
|
## Usage
|
|
|
|
Start server:
|
|
|
|
```
|
|
pgweb --host localhost --user myuser --db mydb
|
|
```
|
|
|
|
You can also specify a connection URI instead of individual flags:
|
|
|
|
```
|
|
pgweb --url postgres://user:password@host:port/database
|
|
```
|
|
|
|
It works great with [Heroku Postgres](https://postgres.heroku.com) if you need
|
|
to troubleshoot production database or simply run a few queries.
|
|
|
|
Full CLI options:
|
|
|
|
```
|
|
Usage:
|
|
pgweb [OPTIONS]
|
|
|
|
Application Options:
|
|
-v, --version Print version
|
|
-d, --debug Enable debugging mode (false)
|
|
--url= Database connection string
|
|
--host= Server hostname or IP (localhost)
|
|
--port= Server port (5432)
|
|
--user= Database user (postgres)
|
|
--pass= Password for user
|
|
--db= Database name (postgres)
|
|
--ssl= SSL option (disable)
|
|
--bind= HTTP server host (localhost)
|
|
--listen= HTTP server listen port (8080)
|
|
--auth-user= HTTP basic auth user
|
|
--auth-pass= HTTP basic auth password
|
|
-s, --skip-open Skip browser open on start
|
|
```
|
|
|
|
## Compile from source
|
|
|
|
Go 1.3+ is required. You can install Go with `homebrew`:
|
|
|
|
```
|
|
brew install go
|
|
```
|
|
|
|
To compile source code run the following command:
|
|
|
|
```
|
|
make setup
|
|
make dev
|
|
```
|
|
|
|
This will produce `pgweb` binary in the current directory.
|
|
|
|
There's also a task to compile binaries for other operating systems:
|
|
|
|
```
|
|
make build
|
|
```
|
|
|
|
Under the hood it uses [gox](https://github.com/mitchellh/gox). Compiled binaries
|
|
will be stored into `./bin` directory.
|
|
|
|
|
|
## Use in Docker
|
|
|
|
|
|
|
|
Build the image. (Docker version 1.1)
|
|
|
|
```
|
|
docker build -t your-username/pgweb .
|
|
```
|
|
|
|
Run the container
|
|
|
|
```
|
|
docker run [OPTIONS of docker] your-username/pgweb [OPTIONS of pgweb]
|
|
```
|
|
|
|
#### demo:
|
|
|
|
postgresql container:
|
|
|
|
```
|
|
docker run -d --name="postgresql" \
|
|
-p 5432:5432 \
|
|
-e USER="testuser" \
|
|
-e DB="testdb" \
|
|
-e PASS="test123" \
|
|
paintedfox/postgresql
|
|
|
|
```
|
|
pgweb containers:
|
|
|
|
```
|
|
docker run -d -p 8082:8080 your-username/pgweb \
|
|
--url postgres://testuser:test123@your-ip:5432/testdb \
|
|
--bind 0.0.0.0
|
|
|
|
```
|
|
Then open [http://your-ip:8082](#) in your browser
|
|
|
|
## Contributors
|
|
|
|
- Dan Sosedoff - https://twitter.com/sosedoff
|
|
- Masha Safina - https://twitter.com/mashasafina
|
|
|
|
## License
|
|
|
|
The MIT License (MIT)
|
|
|
|
Copyright (c) 2014 Dan Sosedoff, <dan.sosedoff@gmail.com>
|