Code Monkey home page Code Monkey logo

nyx's Introduction

nyx - Imageboard

A simple, dependency-free image board.

screenshot

Requirements

  • HTTPS Capable Host
  • Being able to compile and run a go binary
  • Disk Space

Installation

Simply go get the source code or compile it otherwise, dependencies are included.

Usage

By default nyx works in volatile-mode, all changes are only stored in memory and default credentials are setup in the database.

To overwrite these defaults, simply create the file config.yml or specify another file via the -config flag.

Hostnames

Nyx seperates hostnames as distinct namespaces with their own content.

At the moment you cannot port content between namespaces.

Administration

The administration panel is available under /admin/ (don't forget the trailing slash), the default login is admin with password admin. It is recommended to add a new administrator and delete the default ID.

Here you can add boards, set board rules and start a database cleanup.

The cleanup will remove entries older than 7 days, deleted and orphaned threads and replies.

Once logged in as administrator you can also delete posts on the setup boards or mark your own posts as special (though still anonymous)

Posting

Posts are limited to 10k characters and uploads to 10MB including Base64 overhead (realistically you should be able to upload a 7MB file)

Nyx includes a system called "Trollthrottle". It will rate content based on how well it compresses, it's length and number of lines and the occurence of (currently fixed) keywords.

The end result is a spam score and a captcha probability, both displayed along each post. The captcha probability specifies how like it is that a user will fail a captcha despite having entered it correctly. This is capped at 99%, which means only 1 out of 100 correct solutions will be accepted.

This systems does not stop all trolls but will make it harder for people to post spam by forcing them to do more work.

TripCodes

Tripcodes are non-traditional, they are calculated as the first 8 bytes of the Blake2b Hashsum of the entered Code in Base64 Encoding.

Tripcodes do not offer a guarantee that a user is who they say they are as the codes can be trivially cracked even on a mobile device.

Configuration

The configuration file is written in YAML.

The following is a list of options available (and supported);

  • secret - Secret used for User Login, CSRF and Session Management, default is changeme
  • listen_on - Defaults to :8080, specifies on which port the HTTP server is launched. Nyx will not utilize this value otherwise so proxying is safe.
  • hosts - A whitelists of hostnames that are allowed to be used. Nyx uses hostnames to differentiate several board collections.
  • db.file - File to use for data storage, defaults to :memory: which means in-memory storage
  • site.title - Site Title
  • site.description - Site Description
  • captcha - Captcha Mode, currently only internal is supported

The config accepts other options but these may not be supported.

Asked Questions

  • Where is the demo?

  • It's available here: https://nyx.demo.bjphoster.com (it resets every 6 hours, it's just to "try and buy" the software, )

  • Where and how is data stored?

  • Nyx uses a KV-Stored called BuntDB. It features in-memory storage and JSON-indexing, Nyx currently only takes advantage of the in-memory storage however. It enables Nyx to operate in "demo mode", leaving no trace on a computer if it's not explicitly configured. Inside the KV Store all data is encoded with JSON.

  • Why no javascript?

  • The lack of Javascript makes Nyx a simple webservice. No public API or complicated authentication. Just Vanilla Go Templates and clean endpoints. I also suck at JS so that helped.

  • Why make an image board?

  • One, there isn't much software out there for this, Wakaba and similar software runs mostly on perl and not on the shared hosting service I use. Nyx is designed to run everywhere without dependencies and without configuration. Secondly, I wanted to see if I could make an imageboard over a weekend, which I succeeded in doing (as you can see).

  • How can I migrate/convert/upgrade the database?

  • The database doesn't migrate old entries, I think that for this application it's more important that new threads and replies work, old data will simply be parse with fallbacks and phased out over time. Currently there is also no way to export or migrate the database, even just between hostnames.

ToDo

  • Moderation needs to be worked on, currently only global administrators work
  • Video Files might be implemented, though they will most likely require some extra work on the database side, as streaming video from JSON encoded entries will be anything but efficient. The first step would be to enable Nyx to stream content without loading it in memory.
  • MSGPACK encoding instead of JSON
  • More efficient KV usage, images and thumbnails should be moved into seperate entries so that decoding thread and reply data is less costly.
  • Implement Host-Whitelisting more efficiently
  • Manual Hostname Whitelisting (only enable admin panels globally)
  • Global links (kinda like WordPress: "home URL" to be hosted in a subdirectory path, and "board root URL" to "return home" from inside a board)
  • Admin panel refactoring
    • Password change, instead of deleting an entry and re-creating with a different password
    • Board deletion
    • Modern-ish admin panel restyling
  • Database Tool for the following functions:
    • Online & Offline Management
    • Manage Administrators and Moderators
    • Manage Hostnames
    • Manage Boards, Threads and Replies
    • Export / Dump Database
    • Import / Upgrade Database

nyx's People

Contributors

bryanpedini avatar tscs37 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

nyx's Issues

code in directory [...] expects import "gopkg.in/hlandau/passlib.v1"

Cloning the repository inside $GOPATH/src/github.com/nyx doesn't work, go getting the code from github doesn't work, go getting the code from your server doesnt work...
The result is the same response is over, and over and over:

code in directory /home/bryanpedini/projects/go/src/go.rls.moe/nyx/vendor/github.com/hlandau/passlib expects import "gopkg.in/hlandau/passlib.v1"

I'm currently on Debian 10 Buster Stable, with Plasma KDE and Go v1.14.1 linx/amd64.
Hook me up in case you need any help sorting this one out, I'm really hoping to get it working because I really need this board!

It's demo time

Didn't you want a demo server?
After creating the Docker image, I then proceeded to build another one on top of it, with a default SQLite3 database with admin informations changed, and predefined boards (with captcha disabled).

And thanks to the power of Nginx's locations and a cronjob that restarts the Docker container, effectively resetting the entire website, to prevent database growth and too much spam/flood, there you have it here.

relocation target runtime.support_avx not defined

After solving #1 (with PR #2), I finally tried to build the project and who knew another problem arised...

This one tho seems I'm not able to either understand or solve correctly:

# go.rls.moe/nyx
go.rls.moe/nyx/vendor/golang.org/x/crypto/blake2b.supportsAVX2: relocation target runtime.support_avx2 not defined
go.rls.moe/nyx/vendor/golang.org/x/crypto/blake2b.supportsAVX: relocation target runtime.support_avx not defined

This issue will need to be taken by the original author, and I cannot help with it.
I've already searched online and it suggests that the problem has to do with wrapping and the CPU detection features of the crypto library, which, having never used it, I don't know even how it works, let alone solve a problem with it.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.