Thanks! I don’t imagine this will be the case (considering you have to pay for it), but when Discord unblocks Roblox again, hopefully this will stay up unlike Osyris’s proxy did?
I will say currently, using discordapp.com/api instead of discord.com/api for your webhook link works. This might stop being the case eventually, though.
That’s the plan. If I’m ever going to take it down, I’ll give a notice a couple months prior so that people can migrate, but I see no reason to take it down if webhooks return.
The difference between my proxy and what people tend to do is that people blindly sent requests to webhooks. My proxy doesn’t permit this; it deals with ratelimiting itself so it doesn’t hit Discord if you’re out of requests.
This setup just exposes the proxy publicly with no reverse proxy. Recommended to start with only, but you should probably use the correct setup as soon as possible.
Install Node.js on your server. This can be done through a package manager or through nvm. The minimum requirement is v16.
Install git. This is usually a default tool nowadays, but just grab it off of your package manager if you don’t have it.
Install Redis or its Windows equivalent Memurai (please note Memurai is paid software and you should probably just go put Redis in a Docker container instead on Windows, however for testing purposes Memurai will work fine). You need at least v6.2 due to the commands used, though v7 and above is preferable.
Install pm2 and yarn (npm i -g pm2 yarn)
Run git clone https://github.com/LewisTehMinerz/webhook-proxy to clone the proxy.
Enter the resultant webhook-proxy folder.
Copy the .example.json files to the same name, just without .example (e.g., config.example.json → config.json).
Modify the files as you need, primarily config.json.
Run yarn && yarn build. This will install the necessary dependencies and build the project.
Run pm2 start dist/index.js --name=webhook-proxy. This will start the app under the name webhook-proxy in pm2.
If you wish to run this on startup, run pm2 startup, follow the instructions there, and then run pm2 save.
You should be good to go! Future updates just require a simple yarn update.
The Correct Setup
This setup involves using a reverse proxy instead of exposing the server directly and using a cluster instead of a single process. This is recommended (and the correct way), but a bit more complicated. This is how I actually run the proxy. This is how I used to run the proxy. I’m now using Cloudflare Tunnel, however this is still the recommended way of doing things that keeps it simple.
Install nginx. This will be our front-facing web server.
Update your configuration and set trustProxy to true.
Create a new site in nginx with the following configuration:
(it is recommended you enable SSL and HTTP2 but this is out of scope for this setup)
Reload nginx and pm2 restart webhook-proxy. You should be good to go.
(Optional) Depending on your load requirements, you may want to cluster WebhookProxy to deal with a large amount of Roblox servers. If you have >50 servers sending webhook requests frequently, you may need to scale. To do so, run pm2 delete webhook-proxy, and then run pm2 start dist/index.js --name=webhook-proxy -i 1. This will run it in a clustered mode instead of the standard fork mode.
From here, you can now scale the proxy up and down as you need to by doing pm2 scale webhook-proxy <worker count>. This is good for games that are growing that need to send a lot of webhook requests as you can just put on more workers as needed.
Please note that the benefits of clustering come from having multiple CPU cores. If you do not have more than one core on your server, this will not benefit you and will most likely reduce performance from the overhead of clustering and the workers fighting each other for resources.
Enabling Queues
A new feature of the proxy is the queue system. This requires some extra (but simple) setup.
Edit your configuration to enable queues, and point to your RabbitMQ installation (it should just be the default value that I’ve provided, but in case you’ve changed anything you can set it here).
Restart the proxy (pm2 restart webhook-proxy).
Start the queue processor with pm2 start dist/queueProcessor.js --name=webhook-proxy-processor.
Run pm2 save as well if necessary.
You should be good to go! Try adding /queue onto your webhook requests!
With the newer updates of the proxy, you can now just run yarn update and, as long as you have the setup as described in this guide, it will automatically update the proxy for you. If a yarn update fails, try running it again. It could be that I updated the script.
This is really helpful and all, but I think you could make this a little more efficient by using ProxyService.
This could be used as a means to provide a global proxy, instead of selectively using it for webhooks. This can help if you want to access APIs or such outside of Roblox’s useragent. I personally set it up and it was the same amount of work as this. They’re both doing essentially the same thing but yea. Thought I’d contribute that, however, good post. This is very helpful.
The point is to avoid running a ProxyService instance. I don’t want people using my server to make any web request they want. I wanted to keep the focus restricted to webhooks so that people can’t use my server to perform malicious web requests.
It would also mean I have to give out access keys, whilst this is publicly accessible.
If I have to simplify that into a short message instead (which is probably it), I think I will just use Guilded to log this stuff. All I’m doing with the webhooks is logging potential exploiters, admin command usage, and if an exploiter who was autobanned tried rejoining the game afterwards.
@CoolJohnnyboy If you can’t tell by the reply I gave you, I’m exhausted. Phew!
I did some research into your issue, you seem to be missing https:// off of the link. HTTPService doesn’t really like this much. Can you try adding it and seeing what happens?
discordapp has fallen. (Now I, Starscream, lead the Decepticons!)
Confirming for any future posters that this proxy is working. If you’re having issues, doublecheck your webhook URL. Remember to include https:// and that all that’s replaced with the proxy’s URL is discord.com or discordapp.com.
I’ll be hosting your proxy on rblx-discord-webhook.us-3.evennode.com. That will save time on behalf of game developers who would have to host it themselves.