abyss

abyss is a basic and mostly single user http server written in go made for uploading files (logs, images) and then sharing them to the internet

features

file uploads: supports uploading various file types, including images, videos, and documents.
flexible media display: automatically renders uploaded files on a webpage based on their type (images, pdfs, videos, or plain text).
customizable interface: allows for easy modification of color schemes and layout to suit specific design needs.
syntax highlighting for code: syntax highlighting available by default for code files, with support for multiple programming languages. (can be tweaked/changed and even removed)
security considerations: as it is single user, it's mostly secure but there are still some edges to sharpen

running abyss
- installing with docker
- installing manually
uploading files
theming
docs
todo list

running:

run ./generate_config.sh to setup the necessary environment variables

docker

to run with docker, you can use the docker-compose.yml file available in this repo. to do so, run:

docker compose up -d # might be docker-compose depending on distro

you can optionally use the docker image directly and set it up how you want

manual

to run it manually, build it with go build -o abyss and run:

./abyss

uploading

with curl

to upload your files with curl:

curl -F "file=@/path/to/file" -H "X-Auth: "$(cat /path/to/.key) http://localhost:3235/

you should probably create an alias or a function to do this automatically for you.

click for an example for bash/zsh:

pst() {
  local file

  if [[ -p /dev/stdin ]]; then
    file=$(mktemp)
    cat > "$file"
  elif [[ -n $1 ]]; then
    file="$1"
  else
    echo "Usage: pst [file]"
    return 1
  fi

  curl -F "file=@$file" -H "X-Auth: $(cat ~/.key)" http://localhost:3235

  if [[ -p /dev/stdin ]]; then
    rm "$file"
  fi
}

click for an example for fish shell:

function pst
    set -l file

    if command test -p /dev/stdin
        set file "/tmp/tmp.txt"
        cat > $file
    else if test -n "$argv[1]"
        set file "$argv[1]"
    end

    curl -F "file=@$file" -H "X-Auth: $(cat ~/.key)" http://localhost:3235

    if command test -p /dev/stdin
        rm "$file"
    end
end

through the browser

you can only upload text through the browser, to do so, simply write text in the form in the default webpage and click upload.
this upload can be restricted to need authentication or not, controlled by an environment variable.

theming

there is an example homepage in static/ you can edit directly, which the server will serve automatically
if running with docker, it's also possible to override /static inside the container with your own page.
- otherwise you will need to clone this repository and edit static/ and templates/ manually, or recreate the structure.
same thing with templates in templates/
- it is preferred to use dev/ for that reason, since it is git-ignored and that way makes it easier if wanting to update regularly without making changes to the tree

docs

ABYSS_URL: this is used for the correct formatting of the response of curl.
AUTH_USERNAME | AUTH_PASSWORD: this is used to access /tree, which shows all uploaded files
UPLOAD_KEY: this is key checked when uploading files. if the key doesn't match with server's one, then it refuses uploading.
ABYSS_FILEDIR: this points to the directory where abyss will save the uploads to. defaults to ./files
ABYSS_PORT: this is the port the server will run on. safe to leave empty. defaults to 3235
SHOULD_AUTH: if it is yes, then to upload text through the browser you will need authentication (same auth as /tree), any value other than that and upload is auth-less

todo:

add upload of logs funcionality (like 0x0.st)
add docker easy setup
~~add db for tracking of file names~~ (dont need that)
add file browser (like file://)
add file extension in its name
login prompt when accessing /tree
home page
custom file displaying!!
syntax highlighting
add rate limits

4.4 KiB Raw Blame History