mirror of
https://github.com/fosrl/docs-v2.git
synced 2026-02-07 21:46:42 +00:00
80 lines
2.6 KiB
Plaintext
80 lines
2.6 KiB
Plaintext
---
|
|
title: "Client Resources"
|
|
description: "Configure resources for Olm clients to access on a Newt site"
|
|
---
|
|
|
|
## Overview
|
|
|
|
Site resources in Pangolin allow you to define specific ports and a destination that can be accessed through the VPN tunnel when using [Olm clients](/manage/clients/add-client). This is useful for exposing internal services to your remote clients securely.
|
|
|
|
<Note>
|
|
Site resources are only for exposing services on a Newt site to Olm clients running remotely and do not get proxied.
|
|
</Note>
|
|
|
|
## Internal Exposure with Clients
|
|
|
|
Internal exposure resources are only accessible when connected via an Olm client. This approach is perfect for secure access to services without exposing them to the public internet.
|
|
|
|
When you run Newt with `--accept-clients`, it operates fully in user space without creating a virtual network interface on the host. This means:
|
|
|
|
- **No special permissions required** for the container or binary
|
|
- **No virtual network interface** created on the host
|
|
- **Client-only access** through Pangolin's tunnel
|
|
- **Secure internal routing** to your services
|
|
|
|
## Configuring Site Resources
|
|
|
|
To configure site resources:
|
|
|
|
<Steps>
|
|
<Step title="Navigate to Resources">
|
|
Navigate to the **Resources** section in the Pangolin dashboard.
|
|
</Step>
|
|
<Step title="Select Site Resources">
|
|
In the toggle at the top of the table, select "Site Resources".
|
|
</Step>
|
|
<Step title="Add Resource">
|
|
Click **Add Resource**.
|
|
</Step>
|
|
<Step title="Choose Resource Type">
|
|
Choose the resource type (TCP or UDP).
|
|
</Step>
|
|
<Step title="Configure Port and Target">
|
|
Specify the local port and the target address.
|
|
</Step>
|
|
</Steps>
|
|
|
|
## Accessing Site Resources
|
|
|
|
Once configured, you can access these resources from your remote clients using the Olm tunnel.
|
|
|
|
### Example: SSH Access
|
|
|
|
Here's how to set up SSH access to your server when connected with a client:
|
|
|
|
<Steps>
|
|
<Step title="Create the resource">
|
|
In the Pangolin dashboard, create a new client resource and set the port to `2022` (or any available port).
|
|
|
|
<Frame>
|
|
<img src="/images/client_resource.png" width="400" centered/>
|
|
</Frame>
|
|
</Step>
|
|
|
|
<Step title="Connect and access">
|
|
When connected with a Olm client, you can SSH to your server using `<site-address>:2022`.
|
|
|
|
```bash
|
|
ssh user@100.90.128.0 -p 22
|
|
```
|
|
<Note>
|
|
When accessing a site resource, you use the IP of the site found in the dashboard and the local port you configured for the resource.
|
|
</Note>
|
|
</Step>
|
|
</Steps>
|
|
|
|
<Note>
|
|
This approach is ideal for secure remote access without exposing SSH directly to the internet.
|
|
</Note>
|
|
|