Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
C
cfdns
Manage
Activity
Members
Labels
Plan
Issues
0
Issue boards
Milestones
Wiki
Code
Merge requests
2
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Package Registry
Container Registry
Model registry
Operate
Environments
Terraform modules
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
Louis
cfdns
Commits
fc14fc00
Unverified
Commit
fc14fc00
authored
5 years ago
by
Louis
Browse files
Options
Downloads
Patches
Plain Diff
Add README.md
parent
395469ac
No related branches found
Branches containing commit
No related tags found
No related merge requests found
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
README.md
+33
-0
33 additions, 0 deletions
README.md
with
33 additions
and
0 deletions
README.md
0 → 100644
+
33
−
0
View file @
fc14fc00
# CFDNS
Dynamic server DNS backed by cloudflare
## Why?
If you run a server without a static IP address (e.g. at home), it can be
cumbersome or expensive to keep a domain name updated with the latest IP
that has been assigned to you.
Compatible with a free Cloudflare account, this script can keep you updated
and online
## How?
This will be written from the perspective of someone running a server in their
house with a residential intenret connection backed by a provider such as Virgin
media.
1.
In your DHCP settings, assign a static IP address to the machine that should
serve requests
2.
With UPnP, port forward the relevant ports for access. This may be
`80`
and
`22`
for standard HTTP and SSH access
3.
`git clone`
this script to a target directory
4.
`npm install`
the dependencies
5.
`cp config.example.json config.json`
and fill in the relevant details.
1.
The
`zone_id`
can be found by going to the cloudflare dashboard and looking
at the overview for a given domain. On the right hand side are a series of
settings - see
`1`
2.
Create an API token for the application. The link to do so (
`2`
) is located
just underneath the Zone ID. The token only needs
`edit`
permissions on the
`Zone DNS`
6.
Set up a cron (or other scheduling option) to invoke the script at regular intervals
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment