mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-06-15 04:47:00 +00:00
complete i18n migration to /[locale]/ with EN+ES content
Full rewrite of the docs site under app/[locale]/ with next-intl in localePrefix:"always" mode. Every page now exists at both /en/<path> and /es/<path>; the root / shows a meta-refresh + JS redirect to /<defaultLocale>/ so GitHub Pages serves something on the apex URL. Highlights: - 107 doc pages migrated to file-per-page JSON namespaces under messages/en/ and messages/es/. Spanish content is fully translated (no copy-of-English placeholders). - New documentation for the Active Suppressions section in the Settings tab and the per-event Dismiss dropdown in the Health Monitor modal. - New screenshots: dismiss-duration-dropdown.png and an updated health-suppression-settings.png. - Pagefind integrated for client-side search; index is built on every CI deploy (not committed). - RSS feeds: per-locale at /<locale>/rss.xml plus root /rss.xml for backward compat. - Removed the dead app/[locale]/guides/[slug]/ route — every guide now has its own static page and no markdown source remains. - Fixed orphan link /guides/nvidia -> /guides/nvidia-manual in docs/hardware/nvidia-host. - Removed obsolete components (footer2, calendar, drawer). Verified locally with `npm ci && npm run build`: 2804 files in out/, 231 pages indexed by pagefind, root redirect intact, both locale roots and the new Active Suppressions docs render OK.
This commit is contained in:
355
web/app/[locale]/docs/storage-share/host-samba/page.tsx
Normal file
355
web/app/[locale]/docs/storage-share/host-samba/page.tsx
Normal file
@@ -0,0 +1,355 @@
|
||||
import type { Metadata } from "next"
|
||||
import { getTranslations, getMessages, setRequestLocale } from "next-intl/server"
|
||||
import { Link } from "@/i18n/navigation"
|
||||
import Image from "next/image"
|
||||
import { DocHeader } from "@/components/ui/doc-header"
|
||||
import { Callout } from "@/components/ui/callout"
|
||||
import CopyableCode from "@/components/CopyableCode"
|
||||
|
||||
export async function generateMetadata({
|
||||
params,
|
||||
}: {
|
||||
params: Promise<{ locale: string }>
|
||||
}): Promise<Metadata> {
|
||||
const { locale } = await params
|
||||
const t = await getTranslations({ locale, namespace: "docs.storageShare.hostSamba.meta" })
|
||||
return {
|
||||
title: t("title"),
|
||||
description: t("description"),
|
||||
openGraph: {
|
||||
title: t("ogTitle"),
|
||||
description: t("ogDescription"),
|
||||
type: "article",
|
||||
url: "https://macrimi.github.io/ProxMenux/docs/storage-share/host-samba",
|
||||
},
|
||||
}
|
||||
}
|
||||
|
||||
type StringItem = string
|
||||
type ModesRow = { method: string; mount?: string; mountRich?: string; ui: string; useCase?: string; useCaseRich?: string }
|
||||
type ContentRow = { type: string; allows?: string; allowsRich?: string }
|
||||
type RelatedItem = { href: string; label: string; tail?: string; tailRich?: string }
|
||||
|
||||
export default async function HostSambaPage({
|
||||
params,
|
||||
}: {
|
||||
params: Promise<{ locale: string }>
|
||||
}) {
|
||||
const { locale } = await params
|
||||
setRequestLocale(locale)
|
||||
const t = await getTranslations({ locale, namespace: "docs.storageShare.hostSamba" })
|
||||
|
||||
const messages = (await getMessages({ locale })) as unknown as {
|
||||
docs: { storageShare: { hostSamba: {
|
||||
modes: { rows: ModesRow[] }
|
||||
pvesmBranch: { items: StringItem[]; rows: ContentRow[] }
|
||||
fstabBranch: { items: StringItem[]; applies: StringItem[] }
|
||||
related: { items: RelatedItem[] }
|
||||
} } }
|
||||
}
|
||||
const modesRows = messages.docs.storageShare.hostSamba.modes.rows
|
||||
const pvesmItems = messages.docs.storageShare.hostSamba.pvesmBranch.items
|
||||
const contentRows = messages.docs.storageShare.hostSamba.pvesmBranch.rows
|
||||
const fstabItems = messages.docs.storageShare.hostSamba.fstabBranch.items
|
||||
const fstabAppliesItems = messages.docs.storageShare.hostSamba.fstabBranch.applies
|
||||
const relatedItems = messages.docs.storageShare.hostSamba.related.items
|
||||
|
||||
const code = (chunks: React.ReactNode) => <code>{chunks}</code>
|
||||
const strong = (chunks: React.ReactNode) => <strong>{chunks}</strong>
|
||||
const em = (chunks: React.ReactNode) => <em>{chunks}</em>
|
||||
const mountLink = (chunks: React.ReactNode) => (
|
||||
<Link href="/docs/storage-share/lxc-mount-points" className="text-blue-700 hover:underline">{chunks}</Link>
|
||||
)
|
||||
|
||||
return (
|
||||
<div>
|
||||
<DocHeader
|
||||
title={t("header.title")}
|
||||
description={t("header.description")}
|
||||
section={t("header.section")}
|
||||
estimatedMinutes={7}
|
||||
scriptPath="share/samba_host.sh"
|
||||
/>
|
||||
|
||||
<Callout variant="info" title={t("intro.title")}>
|
||||
{t.rich("intro.body", { code, strong })}
|
||||
</Callout>
|
||||
|
||||
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("opening.heading")}</h2>
|
||||
<p className="mb-4 text-gray-800 leading-relaxed">
|
||||
{t.rich("opening.body", { strong })}
|
||||
</p>
|
||||
|
||||
<Image
|
||||
src="/share/host-samba-menu.png"
|
||||
alt={t("opening.imageAlt")}
|
||||
width={900}
|
||||
height={500}
|
||||
className="rounded shadow-lg my-6"
|
||||
/>
|
||||
|
||||
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("howRuns.heading")}</h2>
|
||||
<p className="mb-4 text-gray-800 leading-relaxed">
|
||||
{t.rich("howRuns.body", { code })}
|
||||
</p>
|
||||
|
||||
<pre className="bg-gray-100 text-gray-800 p-4 rounded-md overflow-x-auto text-sm my-4 border border-gray-200 leading-snug">
|
||||
{`┌─────────────────────────────────────────────┐
|
||||
│ PHASE 1 — Discover, validate, choose │
|
||||
│ (nothing touched yet) │
|
||||
└──────────────────┬──────────────────────────┘
|
||||
▼
|
||||
Server discovery (nmap 139/445 + nmblookup)
|
||||
│
|
||||
▼
|
||||
Authentication (User or Guest)
|
||||
│
|
||||
▼
|
||||
Share selection (smbclient -L)
|
||||
│
|
||||
▼
|
||||
╔═════════════════════════════════════╗
|
||||
║ MOUNT METHOD PICKER (checklist) ║
|
||||
║ [ ] As Proxmox storage (pvesm) ║
|
||||
║ [ ] As host fstab mount only ║
|
||||
║ (mark one or both — re-prompts ║
|
||||
║ if you press OK without marks) ║
|
||||
╚════════════════╤════════════════════╝
|
||||
│
|
||||
┌──────────────┴──────────────┐
|
||||
▼ ▼
|
||||
pvesm branch fstab branch
|
||||
├─ storage ID ├─ mount path
|
||||
├─ content types ├─ mount options
|
||||
└─ (User) write
|
||||
/etc/samba/credentials/...cred
|
||||
(mode 0600)
|
||||
▼ ▼
|
||||
┌─────────────────────────────────────────┐
|
||||
│ PHASE 2 — Apply (only marked methods) │
|
||||
└──────────────────┬──────────────────────┘
|
||||
▼
|
||||
pvesm add cifs <id> ... + mkdir -p <path>
|
||||
(auto-mount at mount -t cifs ...
|
||||
/mnt/pve/<id> with (uid=0,gid=0,
|
||||
default options) file_mode=0777,
|
||||
dir_mode=0777)
|
||||
append /etc/fstab
|
||||
systemctl daemon-reload
|
||||
▼
|
||||
Summary printed`}
|
||||
</pre>
|
||||
|
||||
<h2 className="text-2xl font-semibold mt-12 mb-4 text-gray-900">{t("modes.heading")}</h2>
|
||||
<p className="mb-4 text-gray-800 leading-relaxed">{t("modes.intro")}</p>
|
||||
|
||||
<div className="overflow-x-auto mb-4 rounded-md border border-gray-200">
|
||||
<table className="min-w-full text-sm">
|
||||
<thead className="bg-gray-50 text-left text-gray-700">
|
||||
<tr>
|
||||
<th className="px-4 py-2 font-semibold">{t("modes.headerMethod")}</th>
|
||||
<th className="px-4 py-2 font-semibold">{t("modes.headerMount")}</th>
|
||||
<th className="px-4 py-2 font-semibold">{t("modes.headerUi")}</th>
|
||||
<th className="px-4 py-2 font-semibold">{t("modes.headerUseCase")}</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody className="divide-y divide-gray-200 text-gray-800 align-top">
|
||||
{modesRows.map((row, idx) => (
|
||||
<tr key={idx}>
|
||||
<td className="px-4 py-2">{t.rich(`modes.rows.${idx}.method`, { strong })}</td>
|
||||
<td className="px-4 py-2">
|
||||
{row.mountRich ? t.rich(`modes.rows.${idx}.mountRich`, { code }) : row.mount}
|
||||
</td>
|
||||
<td className="px-4 py-2">{row.ui}</td>
|
||||
<td className="px-4 py-2">
|
||||
{row.useCaseRich ? t.rich(`modes.rows.${idx}.useCaseRich`, { em }) : row.useCase}
|
||||
</td>
|
||||
</tr>
|
||||
))}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<Callout variant="info" title={t("modes.bothTitle")}>
|
||||
{t.rich("modes.bothBody", { code })}
|
||||
</Callout>
|
||||
|
||||
<h2 className="text-2xl font-semibold mt-12 mb-4 text-gray-900">{t("pvesmBranch.heading")}</h2>
|
||||
<p className="mb-4 text-gray-800 leading-relaxed">
|
||||
{t.rich("pvesmBranch.intro", { em })}
|
||||
</p>
|
||||
|
||||
<ol className="list-decimal pl-6 mb-4 text-gray-800 leading-relaxed space-y-2">
|
||||
{pvesmItems.map((_, idx) => (
|
||||
<li key={idx}>{t.rich(`pvesmBranch.items.${idx}`, { strong, em, code })}</li>
|
||||
))}
|
||||
</ol>
|
||||
|
||||
<div className="overflow-x-auto mb-4 rounded-md border border-gray-200">
|
||||
<table className="min-w-full text-sm">
|
||||
<thead className="bg-gray-50 text-left text-gray-700">
|
||||
<tr>
|
||||
<th className="px-4 py-2 font-semibold">{t("pvesmBranch.headerType")}</th>
|
||||
<th className="px-4 py-2 font-semibold">{t("pvesmBranch.headerAllows")}</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody className="divide-y divide-gray-200 text-gray-800">
|
||||
{contentRows.map((row, idx) => (
|
||||
<tr key={row.type}>
|
||||
<td className="px-4 py-2 font-mono">{row.type}</td>
|
||||
<td className="px-4 py-2">
|
||||
{row.allowsRich
|
||||
? t.rich(`pvesmBranch.rows.${idx}.allowsRich`, { code, strong })
|
||||
: row.allows}
|
||||
</td>
|
||||
</tr>
|
||||
))}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<Callout variant="warning" title={t("pvesmBranch.warnTitle")}>
|
||||
{t.rich("pvesmBranch.warnBody", { code })}
|
||||
</Callout>
|
||||
|
||||
<Callout variant="info" title={t("pvesmBranch.credsTitle")}>
|
||||
{t.rich("pvesmBranch.credsBody", { code })}
|
||||
</Callout>
|
||||
|
||||
<h2 className="text-2xl font-semibold mt-12 mb-4 text-gray-900">{t("fstabBranch.heading")}</h2>
|
||||
<p className="mb-4 text-gray-800 leading-relaxed">
|
||||
{t.rich("fstabBranch.intro", { em, code })}
|
||||
</p>
|
||||
|
||||
<ol className="list-decimal pl-6 mb-4 text-gray-800 leading-relaxed space-y-2">
|
||||
{fstabItems.map((_, idx) => (
|
||||
<li key={idx}>{t.rich(`fstabBranch.items.${idx}`, { strong, em, code })}</li>
|
||||
))}
|
||||
</ol>
|
||||
|
||||
<Callout variant="info" title={t("fstabBranch.credsTitle")}>
|
||||
{t.rich("fstabBranch.credsBody", { code })}
|
||||
</Callout>
|
||||
|
||||
<p className="mb-3 text-gray-800 leading-relaxed">{t("fstabBranch.appliesIntro")}</p>
|
||||
<ul className="list-disc pl-6 mb-4 text-gray-800 leading-relaxed space-y-1">
|
||||
{fstabAppliesItems.map((_, idx) => (
|
||||
<li key={idx}>{t.rich(`fstabBranch.applies.${idx}`, { code })}</li>
|
||||
))}
|
||||
</ul>
|
||||
|
||||
<Callout variant="info" title={t("fstabBranch.lxcTitle")}>
|
||||
{t.rich("fstabBranch.lxcBody", { code, strong, mountLink })}
|
||||
</Callout>
|
||||
|
||||
<Callout variant="warning" title={t("fstabBranch.noUiTitle")}>
|
||||
{t.rich("fstabBranch.noUiBody", { em })}
|
||||
</Callout>
|
||||
|
||||
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("manual.heading")}</h2>
|
||||
|
||||
<p className="mb-3 text-gray-800 leading-relaxed">{t("manual.pvesmIntro")}</p>
|
||||
<CopyableCode code={`apt-get install -y cifs-utils smbclient # one-time: SMB client tools
|
||||
|
||||
# with user authentication
|
||||
pvesm add cifs mycifs \\
|
||||
--server 10.0.0.50 \\
|
||||
--share proxmox \\
|
||||
--username backup_user \\
|
||||
--password 's3cret' \\
|
||||
--content backup,iso
|
||||
|
||||
# guest access (no credentials)
|
||||
pvesm add cifs mycifs-guest \\
|
||||
--server 10.0.0.50 \\
|
||||
--share public \\
|
||||
--content iso,vztmpl
|
||||
|
||||
pvesm status mycifs # verify it's active
|
||||
ls -la /mnt/pve/mycifs # Proxmox auto-mounts here`} />
|
||||
|
||||
<p className="mb-3 mt-6 text-gray-800 leading-relaxed">{t("manual.fstabUserIntro")}</p>
|
||||
<CopyableCode code={`# 1. credentials file (root-only)
|
||||
mkdir -p /etc/samba/credentials && chmod 0700 /etc/samba/credentials
|
||||
cat > /etc/samba/credentials/nas01_share.cred <<'EOF'
|
||||
username=admin
|
||||
password=s3cret
|
||||
EOF
|
||||
chmod 0600 /etc/samba/credentials/nas01_share.cred
|
||||
|
||||
# 2. mount with open uid/gid/file_mode (for unpriv LXC bind-mounts)
|
||||
mkdir -p /mnt/data
|
||||
mount -t cifs //10.0.0.50/share /mnt/data \\
|
||||
-o "rw,uid=0,gid=0,file_mode=0777,dir_mode=0777,iocharset=utf8,nofail,_netdev,credentials=/etc/samba/credentials/nas01_share.cred"
|
||||
|
||||
# 3. persist
|
||||
echo "//10.0.0.50/share /mnt/data cifs rw,uid=0,gid=0,file_mode=0777,dir_mode=0777,iocharset=utf8,nofail,_netdev,credentials=/etc/samba/credentials/nas01_share.cred 0 0" \\
|
||||
>> /etc/fstab
|
||||
systemctl daemon-reload
|
||||
|
||||
# 4. bind into an unpriv LXC (no changes inside the CT)
|
||||
pct set <ctid> -mp0 /mnt/data,mp=/mnt/data,shared=1,backup=0
|
||||
pct reboot <ctid>`} />
|
||||
|
||||
<p className="mb-3 mt-6 text-gray-800 leading-relaxed">{t("manual.fstabGuestIntro")}</p>
|
||||
<CopyableCode code={`mkdir -p /mnt/public
|
||||
mount -t cifs //10.0.0.50/public /mnt/public \\
|
||||
-o "rw,uid=0,gid=0,file_mode=0777,dir_mode=0777,iocharset=utf8,nofail,_netdev,guest"
|
||||
|
||||
echo "//10.0.0.50/public /mnt/public cifs rw,uid=0,gid=0,file_mode=0777,dir_mode=0777,iocharset=utf8,nofail,_netdev,guest 0 0" \\
|
||||
>> /etc/fstab
|
||||
systemctl daemon-reload`} />
|
||||
|
||||
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("view.heading")}</h2>
|
||||
<p className="mb-4 text-gray-800 leading-relaxed">{t.rich("view.body", { code, em, strong })}</p>
|
||||
|
||||
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("remove.heading")}</h2>
|
||||
<p className="mb-4 text-gray-800 leading-relaxed">{t.rich("remove.body", { code, strong })}</p>
|
||||
|
||||
<Callout variant="warning" title={t("remove.warnTitle")}>
|
||||
{t("remove.warnBody")}
|
||||
</Callout>
|
||||
|
||||
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("test.heading")}</h2>
|
||||
<p className="mb-4 text-gray-800 leading-relaxed">{t.rich("test.body", { code })}</p>
|
||||
|
||||
<h2 className="text-2xl font-semibold mt-12 mb-4 text-gray-900">{t("troubleshoot.heading")}</h2>
|
||||
|
||||
<Callout variant="troubleshoot" title={t("troubleshoot.noServersTitle")}>
|
||||
{t.rich("troubleshoot.noServersBody", { code, em })}
|
||||
</Callout>
|
||||
|
||||
<Callout variant="troubleshoot" title={t("troubleshoot.noSharesTitle")}>
|
||||
{t.rich("troubleshoot.noSharesBody", { code })}
|
||||
</Callout>
|
||||
|
||||
<Callout variant="troubleshoot" title={t("troubleshoot.denyTitle")}>
|
||||
{t.rich("troubleshoot.denyBody", { code })}
|
||||
</Callout>
|
||||
|
||||
<Callout variant="troubleshoot" title={t("troubleshoot.sleepTitle")}>
|
||||
{t.rich("troubleshoot.sleepBody", { code })}
|
||||
</Callout>
|
||||
|
||||
<Callout variant="troubleshoot" title={t("troubleshoot.lxcNoWriteTitle")}>
|
||||
{t.rich("troubleshoot.lxcNoWriteBody", { code })}
|
||||
</Callout>
|
||||
|
||||
<Callout variant="troubleshoot" title={t("troubleshoot.fstabBootTitle")}>
|
||||
{t.rich("troubleshoot.fstabBootBody", { code })}
|
||||
</Callout>
|
||||
|
||||
<h2 className="text-2xl font-semibold mt-10 mb-4 text-gray-900">{t("related.heading")}</h2>
|
||||
<ul className="list-disc pl-6 mb-4 text-gray-800 leading-relaxed space-y-1">
|
||||
{relatedItems.map((item, idx) => (
|
||||
<li key={item.href}>
|
||||
<Link href={item.href} className="text-blue-600 hover:underline">
|
||||
{item.label}
|
||||
</Link>
|
||||
{item.tailRich ? t.rich(`related.items.${idx}.tailRich`, { code }) : item.tail}
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
</div>
|
||||
)
|
||||
}
|
||||
Reference in New Issue
Block a user