mirrors/fuwuqi
1
0
Fork 1
mirror of https://git.exozy.me/a/fuwuqi.git synced 2024-11-22 03:51:02 +00:00
Code Issues Projects Releases Packages Wiki Activity
A useless C2S ActivityPub server
25 commits 1 branch 0 tags 110 KiB
Python 100%
Find a file
Anthony Wang a56c2664dc
Even more code cleanup
2023-01-18 20:07:12 +00:00
.well-known Add static files 2023-01-18 01:19:53 +00:00
users Implement some more server features 2023-01-18 19:48:11 +00:00
accept.jsonld Client addressing for example activities 2023-01-18 14:47:10 -05:00
client.py Even more code cleanup 2023-01-18 20:07:12 +00:00
create.jsonld Client addressing for example activities 2023-01-18 14:47:10 -05:00
follow.jsonld Merge branch 'main' of git.exozy.me:a/fuwuqi 2023-01-18 14:48:32 -05:00
LICENSE Initial commit 2023-01-18 00:18:22 +00:00
README.md More code cleanup 2023-01-18 20:06:17 +00:00
server.py More code cleanup 2023-01-18 20:06:17 +00:00

README.md

fuwuqi

Fuwuqi (fúwùqì or 服务器 means "server" in Chinese) is a useless C2S ActivityPub server for "extremely hardcore" ActivityPub enthusiasts. Craft your own exquisite WebFinger response! Customize your actor object exactly like you want! Hack and extend the (100+ε)-line Python server code! 100% guarenteed™ to federate with Mastodon! It's like Honk, but instead of politely refusing to hold your hand, it chucks you straight into the deep end of the pool.

Configuration

You will need:

  1. 1x server with a domain name and reverse proxy
  2. 1x client device (can be same as server)
  3. 2x Python, cryptography, requests on both server and client
  4. 1x brain fluent in Python and ActivityPub
  5. 1x pain tolerance

First, clone this repo on your server and your client device.

Now, generate an RSA keypair on your client device:

openssl genrsa -out private.pem 2048
openssl rsa -in private.pem -outform PEM -pubout -out public.pem

On the server, rename users/test.jsonld to your username and pop it open in your favorite text editor. You should change 0.exozy.me to match your server's domain name, test to your username, and the publicKeyPem field to the public key you just generated.

Onward! Now open .well-known/webfinger in your editor, and modify it similarly. Finally, open server.py and update the domain, obviously.

That wasn't so bad, was it? (sobbing sounds)

Usage

Alright, time for the real deal. Start up python server.py on your server, and reverse-proxy it so you actually have TLS. If you want to customize the port or whatever, just change the source code.

Now on your client device, open up your favorite C2S ActivityPub client... oh wait... there aren't any! Welp, you'll just have to settle for reading the AP spec, writing some homemade JSON, and figuring out how python client.py works. That's rough, buddy. You'll have to learn how to manually write Notes, manually accept follow requests, and more! You can find some examples in this repo. HTTP signatures are generated client-side, for no good reason other than it works. If you want to view your unread messages, just curl your inbox and pipe it into jq. Easy as that. (screaming in pain sounds)

Enjoy your new "extremely hardcore" ActivityPub server!!! 🎉😎🚀🙃🥳

Features

Since Fuwuqi's code is super duper easy to read and extend, the following features are left as an exercise to the reader:

  • Multi-user support (hint: dynamically generate .well-known/webfinger instead of serving a static file)
  • S2S server-side processing
  • Deleting posts
  • JSON-LD (hint: don't do it, your brain will thank you)
  • Lots of pain

Resources