暫無描述

default 40c748bc5b Don't force HTTP/1.1 connections by default. 2 年之前
doc b2562af8f3 Updated documentation. 2 年之前
examples 89f6924ae2 Improve Docker image generation 2 年之前
.gitignore 0cdd193be9 [.gitignore] new file. 2 年之前
Dockerfile 89f6924ae2 Improve Docker image generation 2 年之前
LICENSE 06c838b523 Updated LICENSE. 2 年之前
Makefile 9858d27818 Makefile improvements 2 年之前
README.md 4afa513dce Add docker-compose support, so a working development server with HTTPS can be started with: 2 年之前
RELEASE_NOTES.md 3d2ce3a8f3 Updated RELEASE_NOTES. 2 年之前
TODO.md 83fe02b488 Updated TODO. 2 年之前
activitypub.c 8461fbfbcc Log the actor request. 2 年之前
data.c 25acaf178c Replaced all calls to post() with enqueue_message(). 2 年之前
docker-compose.yaml 4afa513dce Add docker-compose support, so a working development server with HTTPS can be started with: 2 年之前
format.c 645e7ec43e Some code reordering to placate scan-build's wrath. 2 年之前
html.c 25acaf178c Replaced all calls to post() with enqueue_message(). 2 年之前
http.c 849913dc59 Use the time functions of xs_time.h. 2 年之前
httpd.c a67a82d545 In server_get_handler(), body must be a dynamic string. 2 年之前
main.c 25acaf178c Replaced all calls to post() with enqueue_message(). 2 年之前
snac.c 645e7ec43e Some code reordering to placate scan-build's wrath. 2 年之前
snac.h 427f7341fa New function enqueue_message(). 2 年之前
upgrade.c 67a81a7bf9 Upgrade timeline/ to private/. 2 年之前
utils.c 48ebc54b6e New command line option 'resetpwd'. 2 年之前
webfinger.c 6e0b5c9d20 Fixed typo in webfinger_request(). 2 年之前
xs.h aa82e14bc7 Backport from xs. 2 年之前
xs_curl.h 40c748bc5b Don't force HTTP/1.1 connections by default. 2 年之前
xs_encdec.h fa870ab358 Backport from xs. 2 年之前
xs_glob.h f2528c6c52 Backport from xs. 2 年之前
xs_httpd.h aa82e14bc7 Backport from xs. 2 年之前
xs_io.h 1b73c542a9 Backport from xs. 2 年之前
xs_json.h fa870ab358 Backport from xs. 2 年之前
xs_mime.h 0f4779e2a0 Backport from xs. 2 年之前
xs_openssl.h fa870ab358 Backport from xs. 2 年之前
xs_regex.h f2528c6c52 Backport from xs. 2 年之前
xs_set.h f209c3205d Use xs_set in recipient_list() and inbox_list(). 2 年之前
xs_socket.h 0f4779e2a0 Backport from xs. 2 年之前
xs_time.h ae06064e4d New command-line option purge. 2 年之前
xs_version.h aa82e14bc7 Backport from xs. 2 年之前

README.md

snac

A simple, minimalistic ActivityPub instance

Features

  • Lightweight, minimal dependencies
  • Extensive support of ActivityPub operations, e.g. write public notes, follow users, be followed, reply to the notes of others, admire wonderful content (like or boost), write private messages...
  • Simple but effective web interface
  • Multiuser
  • Easily-accessed MUTE button to silence morons
  • Tested interoperability with related software
  • No database needed
  • Totally JavaScript-free
  • No cookies either
  • Not much bullshit

About

This program runs as a daemon (proxied by a TLS-enabled real httpd server) and provides the basic services for a Fediverse / ActivityPub instance (sharing messages and stuff from/to other systems like Mastodon, Pleroma, Friendica, etc.).

This is not the manual; man pages snac(1) (user manual), snac(5) (formats) and snac(8) (administrator manual) are what you are looking for.

snac stands for Social Networks Are Crap.

Installation

This 2.x release is written in C (unlike the 1.x prototype, which was written in Python). The only external dependencies are openssl and curl.

On Debian/Ubuntu, you can satisfy these requirements by running

    apt install libssl-dev libcurl4-openssl-dev

On OpenBSD you also need to install curl:

    pkg_add curl

Run make and then make install as root.

See the administrator manual on how to proceed from here.

Testing via Docker

A docker-compose file is provided for development and testing. To start snac with an nginx HTTPS frontend, run:

docker-compose build && docker-compose up

This will:

  • Start snac, storing data in data/
  • Configure snac to listen on port 8001 with a server name of localhost (see examples/docker-entrypoint.sh)
  • Create a new user testuser and print the user's generated password on the console (see examples/docker-entrypoint.sh)
  • Start nginx to handle HTTPS, using the certificate pair from nginx-alpine-ssl/nginx-selfsigned.* (see examples/nginx-alpine-ssl/entrypoint.sh)

License

See the LICENSE file for details.

Author

grunfink @grunfink@comam.es