-
Notifications
You must be signed in to change notification settings - Fork 1k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Flycast in the spotlight, or at least its own page (#1747)
* flycast in the spotlight * fix links and redirects * edits * rm --network until confirmed
- Loading branch information
Showing
7 changed files
with
74 additions
and
62 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,62 @@ | ||
--- | ||
title: "Flycast - Private Fly Proxy services" | ||
layout: docs | ||
nav: firecracker | ||
redirect_from: /docs/networking/private-networking/#flycast-private-fly-proxy-services | ||
--- | ||
|
||
Flycast provides network addressing and routing for private apps on Fly.io private networks. With Flycast, requests to your private apps get routed through the Fly Proxy, rather than Machine-to-Machine using `.internal` addresses (the [private networking](/docs/networking/private-networking/) available by default on every app). Unlike `.internal` addresses, with a Flycast address, you don't need to keep Machines running for the app to be reachable. | ||
|
||
Use Flycast to do the following entirely within your organization's private network: | ||
|
||
* Use [Fly Proxy autostop/autostart](/docs/launch/autostart-stop/) for Machines based on network requests. | ||
* Get Fly Proxy's [geographically aware load balancing](/docs/reference/load-balancing/) for private services. | ||
* Connect to a service from another app that can't use DNS. | ||
* Connect from third-party software, like a database, that doesn't support round-robin DNS entries. | ||
* Access specific ports or services in your app from other Fly.io organizations. | ||
* Use advanced Fly Proxy features like TLS termination or PROXY protocol support. | ||
|
||
## Flycast quickstart | ||
|
||
The basic steps to set up Flycast: | ||
|
||
1. Allocate a private IPv6 address for your app on one of your Fly.io organization networks. | ||
2. Make sure your app binds to `0.0.0.0:port`. Binding to `fly-local-6pn:<port>` won't work for Flycast. | ||
3. Expose services in your app's `fly.toml` with an [`[http_service]`](/docs/reference/configuration/#the-http_service-section) or [`[services]`](/docs/reference/configuration/#the-services-sections) section. Don't use `force_https`; Flycast is HTTP-only. | ||
4. Deploy your app. | ||
5. Access the services on the private IPv6 address, or with `my-app-name.flycast`, from the target organization network. | ||
|
||
<div class="warning icon"> | ||
**Warning:** If you have a public IP address assigned to your app, then services in `fly.toml` are exposed to the public internet. Verify your app's IP addresses with `fly ips list`. | ||
</div> | ||
|
||
## Allocate a Flycast address | ||
|
||
A Flycast address is an app-wide private IPv6 address that the Fly Proxy can route to over the private network. By default, the Flycast IP address is allocated on an app's default organization network. | ||
|
||
```cmd | ||
fly ips allocate-v6 --private | ||
``` | ||
```output | ||
VERSION IP TYPE REGION CREATED AT | ||
v6 fdaa:0:22b7:0:1::3 private global just now | ||
``` | ||
|
||
You can use Flycast to expose an app in one Fly.io organization to another Fly.io organization by using the `--org` option when you allocate the Flycast address: | ||
|
||
```cmd | ||
fly ips allocate-v6 --private --org my-other-org | ||
``` | ||
```output | ||
VERSION IP TYPE REGION CREATED AT | ||
v6 fdaa:0:22b7:0:1::3 private global just now | ||
``` | ||
|
||
## Flycast and Fly.io DNS | ||
|
||
Flycast addresses can also be found by using the Fly.io DNS. If an app has a Flycast address allocated to it, there will be an AAAA record at `my-app-name.flycast`. | ||
|
||
## More Flycast | ||
|
||
- [Run private apps with Flycast](/docs/blueprints/private-applications-flycast/) | ||
- [Autostop/autostart for private apps](/docs/blueprints/autostart-internal-apps/) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters