Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/elmasy-com/columbus-server
https://github.com/elmasy-com/columbus-server
subdomain-enumeration subdomain-finder
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/elmasy-com/columbus-server
- Owner: elmasy-com
- License: apache-2.0
- Archived: true
- Created: 2022-10-29T21:34:39.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-08-18T04:08:03.000Z (over 1 year ago)
- Last Synced: 2024-08-03T01:14:46.975Z (6 months ago)
- Topics: subdomain-enumeration, subdomain-finder
- Language: Go
- Homepage: https://columbus.elmasy.com
- Size: 348 KB
- Stars: 28
- Watchers: 0
- Forks: 2
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-rainmana - elmasy-com/columbus-server - (Go)
README
# Columbus server
## This repository is deprecated!
:bangbang: The server component is moved to [https://github.com/elmasy-com/columbus](https://github.com/elmasy-com/columbus).
-----
Columbus Project is an API first subdomain discovery service, blazingly fast subdomain enumeration service with advanced features.
*Columbus returned 638 subdomains of tesla.com in 0.231 sec.*
## Usage
By default Columbus returns only the subdomains in a JSON string array:
```bash
curl 'https://columbus.elmasy.com/lookup/github.com'
```
But we think of the bash lovers, so if you don't want to mess with JSON and a newline separated list is your wish, then include the `Accept: text/plain` header.
```bash
DOMAIN="github.com"
curl -s -H "Accept: text/plain" "https://columbus.elmasy.com/lookup/$DOMAIN" | \
while read SUB
do
if [[ "$SUB" == "" ]]
then
HOST="$DOMAIN"
else
HOST="${SUB}.${DOMAIN}"
fi
echo "$HOST"
done
```
**For more, check the [features](https://columbus.elmasy.com/tools) or the [API documentation](https://columbus.elmasy.com/swagger/index.html).**
## Entries
Currently, entries are got from [Certificate Transparency](https://certificate.transparency.dev/).
## Command Line
```
Usage of columbus-server:
-check
Check for updates.
-config string
Path to the config file.
-version
Print version informations.
```
`-check`: Check the lates version on GitHub.
Prints `up-to-date` and returns `0` if no update required.
Prints the latest tag (eg.: `v0.9.1`) and returns `1` if new release available.
In case of error, prints the error message and returns `2`.
## Build
```bash
git clone https://github.com/elmasy-com/columbus-server
make build
```
## Install
Create a new user:
```bash
adduser --system --no-create-home --disabled-login columbus-server
```
Create a new group:
```bash
addgroup --system columbus
```
Add the new user to the new group:
```bash
usermod -aG columbus columbus-server
```
Copy the binary to `/usr/bin/columbus-server`.
Make it executable:
```bash
chmod +x /usr/bin/columbus-server
```
Create a directory:
```bash
mkdir /etc/columbus
```
Copy the config file to `/etc/columbus/server.conf`.
Set the permission to 0600.
```bash
chmod -R 0600 /etc/columbus
```
Set the owner of the config file:
```bash
chown -R columbus-server:columbus /etc/columbus
```
Install the service file (eg.: `/etc/systemd/system/columbus-server.service`).
```bash
cp columbus-server.service /etc/systemd/system/
```
Reload systemd:
```bash
systemctl daemon-reload
```
Start columbus:
```
systemctl start columbus-server
```
If you want to columbus start automatically:
```
systemctl enable columbus-server
```