Skip to content

docs: clarify distributed networking setup - #34

Open
LouisDeconinck wants to merge 1 commit into
dagucloud:mainfrom
LouisDeconinck:docs/2623-networking-clarifications
Open

docs: clarify distributed networking setup#34
LouisDeconinck wants to merge 1 commit into
dagucloud:mainfrom
LouisDeconinck:docs/2623-networking-clarifications

Conversation

@LouisDeconinck

@LouisDeconinck LouisDeconinck commented Sep 11, 2026

Copy link
Copy Markdown

Summary

  • Explain the loopback default and direct Tailnet binding requirement.
  • Document the Tailscale Serve EOF symptom and raw TCP fix.
  • Add coordinator-initiated reverse SSH forwarding.
  • Clarify health-port disabling and the coordinator health bind behavior.

References dagucloud/dagu#2623

Checks

  • pnpm build
  • pnpm test:worker
  • git diff --check

Summary by cubic

Clarifies the distributed networking docs around loopback defaults, health endpoints, and Tailscale/SSH forwarding.

  • Documents that worker.health-port=0 and coordinator.health-port=0 disable only the local HTTP health endpoint, not gRPC traffic; the coordinator health server binds :8091 independently of coordinator.host.
  • Explains that the coordinator gRPC bind defaults to 127.0.0.1, so Tailnet membership alone does not expose it; set --coordinator.host=0.0.0.0 or bind to the Tailscale interface for direct access.
  • Adds a coordinator-initiated SSH reverse port forwarding setup for workers the coordinator can reach.
  • Ties the error reading server preface: EOF symptom to Tailscale Serve using HTTP/HTTPS mode and points to the raw TCP fix.

Written for commit f0ee235. Summary will update on new commits.

Review in cubic

@coderabbitai

coderabbitai Bot commented Sep 11, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 61e4f3f7-e57a-4d88-b655-620e95e49eb8


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant